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 。

注意 对于 Windows 7，pRuntimeId 指向的整数数组可以包含一组部分 ID，这些 ID 仅标识受结构更改影响的那些元素。

[in] cRuntimeIdLen

类型： int

整数数组的长度。

返回值

类型： HRESULT

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

注解

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

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 | UWP 应用]
目标平台	Windows
标头	uiautomationcoreapi.h
Library	Uiautomationcore.lib
DLL	Uiautomationcore.dll