通过

ComboBox 控件类型

  • 项目

本主题提供有关 Microsoft UI 自动化对 ComboBox 控件类型的支持的信息。

组合框是与静态控件或编辑控件组合在一起的列表框，静态控件或编辑控件在组合框的列表框部分中显示了当前选定的项目。 控件的列表框部分要么将始终显示出来，要么只有当用户选择控件旁边的下拉箭头（下压按钮）时才会出现。 如果选择字段是一个编辑控件，则用户可以输入列表外的信息；否则，用户只能选择列表中的项目。

以下部分定义 ComboBox 控件类型所需的UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于 UI 框架/平台集成UI 自动化控件类型和控件模式支持的所有组合框控件。

本主题包含以下各节：

典型树结构

下表描述了与组合框控件相关的UI 自动化树的典型控件和内容视图，并描述了每个视图中可以包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。

控件视图 内容视图
  • ComboBox
    • Edit（0 个或 1 个）
    • 列出 (0 或 1)
    • List Item（列表的子项；0 到多个）
    • Button（1 个）
  • ComboBox
    • List Item（0 到多个）

 

仅当可以编辑组合框以接受任何输入时，组合框的控件视图中的编辑控件才是必需的，就像 “运行 ”对话框中的组合框的情况一样。

相关属性

下表列出了其值或定义与 ComboBox 控件类型特别相关的UI 自动化属性。 有关UI 自动化属性的详细信息，请参阅从UI 自动化元素检索属性。

UI 自动化属性 值 说明
UIA_AutomationIdPropertyId 请参阅注释。 此属性的值在UI 自动化树的原始视图中的所有对等元素中必须是唯一的。
UIA_BoundingRectanglePropertyId 请参阅注释。 包含整个控件的最外层矩形。
UIA_ClickablePointPropertyId 请参阅注释。 如果存在边界矩形，则受支持。 如果边界矩形中的每个点都不可单击，并且元素执行专门的命中测试，请重写并提供一个可单击的点。
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId 请参阅注释。 组合框控件的帮助文本应说明为何要求用户从组合框中选择一个选项。 文本与通过工具提示呈现的信息类似。 例如，“选择一个项来为你的监视器设置显示分辨率。”
UIA_IsContentElementPropertyId TRUE 组合框控件始终包含在 UI 自动化树的内容视图中。
UIA_IsControlElementPropertyId TRUE 组合框控件始终包含在 UI 自动化树的控件视图中。
UIA_IsKeyboardFocusablePropertyId TRUE 组合框控件可以接收键盘焦点;但是，当UI 自动化客户端将焦点设置为组合框时，组合框子树中的任何项都可以接收焦点。
UIA_LabeledByPropertyId 请参阅注释。 组合框控件通常具有此属性引用的静态文本标签。
UIA_LocalizedControlTypePropertyId 请参阅注释。 对应于 ComboBox 控件类型的本地化字符串。 en-US 或英语 (美国) 的默认值为“组合框”。
UIA_NamePropertyId 请参阅注释。 组合框控件的名称通常是从静态文本标签生成的。 如果没有静态文本标签，则必须为 Name 属性分配一个值。 Name 属性绝不应包含组合框的当前内容，也不应在组合框的内容更改时更改。

 

所需的控件模式

下表列出了需要由所有组合框控件支持的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。

控件模式 支持 说明
IExpandCollapseProvider 必须 必须支持 ExpandCollapse 控件模式，因为组合框控件必须始终包含下拉按钮。
ISelectionProvider 依赖的对象 显示组合框中的当前选择。 对 “选择” 控件模式的支持委托给组合框下面的列表框，但可能并不总是可行的。
IValueProvider 依赖的对象 如果组合框可以采用任意文本值，则必须支持 值 控件模式。 此模式允许以编程方式设置组合框的字符串内容。 如果不支持 Value 控件模式，用户必须从组合框的子树中的列表项中进行选择。
IScrollProvider 从不 在组合框上从不直接支持 滚动 控件模式。 如果组合框中包含的列表框可以滚动，并且仅当列表框在屏幕上可见时，它才受支持。

 

必需事件

下表列出了组合框控件需要支持UI 自动化事件。 有关事件的详细信息，请参阅 F:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty。

UI 自动化事件 说明
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 属性更改事件。
UIA_IsEnabledPropertyId 属性更改事件。 如果控件支持 IsEnabled 属性，则必须支持此事件。
UIA_IsOffscreenPropertyId 属性更改事件。 如果控件支持 IsOffscreen 属性，则必须支持此事件。
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId 属性更改事件。
UIA_ValueValuePropertyId 属性更改事件。 如果控件支持 Value 控件模式，则必须支持此事件。

 

概念性

UI 自动化控件类型概述

UI 自动化概述