UiaRaiseStructureChangedEvent 函数 (uiautomationcoreapi.h)

由提供程序调用，以通知 Microsoft UI 自动化核心树结构已更改。

语法

HRESULT UiaRaiseStructureChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] StructureChangeType       structureChangeType,
  [in] int                       *pRuntimeId,
  [in] int                       cRuntimeIdLen
);

参数

[in] pProvider

类型： IRawElementProviderSimple*

发生树更改的提供程序节点。

[in] structureChangeType

类型： StructureChangeType

树中发生的更改类型。

[in] pRuntimeId

类型： int*

发生树更改的提供程序节点的子元素的运行时 ID。 仅当 structureChangeType为 StructureChangeType_ChildRemoved 时才使用此参数;对于所有其他结构更改事件，它为 NULL 。

[in] cRuntimeIdLen

类型： int

整数数组的长度。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

树结构更改的一个示例是子元素添加到列表框或从列表框中删除，或在树视图中展开或折叠。

要求