UI 自动化控件类型概述

Microsoft UI 自动化控件类型是用作已知标识符的属性,这些标识符指示特定 UI 元素表示的控件类型,例如组合框或按钮。 客户端应用程序使用 类型来标识控件的功能并确定如何与其交互。

本主题包含以下各节:

UI 自动化控件类型必备条件

每个UI 自动化控件类型都有一组与之关联的条件。 当提供程序将控件类型分配给控件时,提供程序必须确保控件满足与该控件类型关联的所有条件。 条件包括:

  • UI 自动化控件模式:每个控件类型都有一组控件必须支持的控件模式、一组可选控件和一组控件不得支持的控件模式。
  • UI 自动化属性值:每个控件类型都具有一组该控件必须支持的属性。
  • UI 自动化事件:每个控件类型都具有一组该控件必须支持的事件。
  • UI 自动化树结构:每个控件类型都将定义该控件必须显示在 UI 自动化树结构中的方式。

当控件满足特定控件类型的条件时, IUIAutomationElement::CurrentControlType (或 IUIAutomationElement::CachedControlType) 属性值将指示该控件类型。

如果控件不符合特定控件类型的规范,请使用 UIA_CustomControlTypeId 作为控件类型 ID,并使用相关的控件模式和属性完全描述控件。 还可以将 UIA_LocalizedControlTypePropertyId 属性设置为最能描述控件类型的字符串。

LocalizedControlType 属性

如果使用预定义的控件类型来描述控件,请使用 UIA_LocalizedControlTypePropertyId 属性的默认值,并允许UI 自动化提供本地化字符串,以便提供程序正确公开。 如果无法使用预定义的控件类型来描述控件,请将 UIA_LocalizedControlTypePropertyId 属性设置为准确描述控件类型的本地化字符串。 该字符串应简洁且足够准确,以便屏幕阅读器等辅助技术可以在 UI 中使用它来通知用户控件的类型。

当前的 UI 自动化控件类型

以下主题介绍UI 自动化控件类型。 对于每个控件类型,说明包括给定类型的控件必须支持的条件集:

参考

控件类型标识符

概念性

支持UI 自动化控件类型

UI 自动化对标准控件的支持

UI 自动化基础知识