structureChangeType 枚举 (uiautomationcore.h)

  • 项目

包含的值指定 Microsoft UI 自动化树结构中的更改类型。

语法

typedef enum StructureChangeType {
  StructureChangeType_ChildAdded = 0,
  StructureChangeType_ChildRemoved,
  StructureChangeType_ChildrenInvalidated,
  StructureChangeType_ChildrenBulkAdded,
  StructureChangeType_ChildrenBulkRemoved,
  StructureChangeType_ChildrenReordered
} ;

常量

 
StructureChangeType_ChildAdded
值： 0
已将子元素添加到 UI 自动化元素树。
StructureChangeType_ChildRemoved
已从 UI 自动化元素树中删除子元素。
StructureChangeType_ChildrenInvalidated
子元素在 UI 自动化元素树中失效。 这可能意味着添加或删除了一个或多个子元素，或者两者的组合。 此值还可以指示 UI 中的一个子树已替换为另一个子树。 例如，对话框的整个内容一次性更改，或者列表视图因 Explorer 类型应用程序导航到其他位置而发生更改。 具体含义取决于 UI 自动化提供程序实现。
StructureChangeType_ChildrenBulkAdded
子元素已批量添加到 UI 自动化元素树。
StructureChangeType_ChildrenBulkRemoved
已从 UI 自动化元素树中批量删除子元素。
StructureChangeType_ChildrenReordered
UI 自动化元素树中子元素的顺序已更改。 子元素可能已添加或删除，也可能未添加或未移除。

注解

由于结构更改事件的实现取决于基础 UI 框架，因此 UI 自动化不定义严格的规则，规定提供程序何时必须从将单个 ChildAdded 或 ChildRemoved 事件切换到批量等效事件。 但是，当一次添加或删除两到五个子元素时，通常会发生开关。 批量事件有助于防止客户端被单个 ChildAdded 和 ChildRemoved 事件淹没。

除 ChildAdded 外，结构更改事件始终与保存子级的容器元素相关联。 ChildAdded 事件与刚刚添加的元素相关联。

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
标头 uiautomationcore.h (包括 UIAutomation.h)