通过

ComboBox 控件类型

  • 项目

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

组合框是一个列表框，它与静态控件或编辑控件组合在组合框的列表框部分显示当前选定的项。 控件的列表框部分随时显示，或者仅当用户选择控件旁边的下拉箭头（即按下按钮）时显示。 如果选择字段是编辑控件，则用户可以输入不在列表中的信息;否则，用户只能选择列表中的项。

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

本主题包含以下部分。

典型树结构

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

控件视图 内容视图
  • ComboBox
    • 编辑 （0 或 1）
    • 列表 （0 或 1）
    • 列表项（List 的子级;0 到多个）
    • 按钮 （1）
  • ComboBox
    • 列表项 （0 到多）

 

只有在可以编辑组合框以接受任何输入时，组合框中的编辑控件才是必需的，“运行”对话框中的组合框的情况也是如此。

相关属性

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

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

 

所需的控件模式

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

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

 

必需事件

下表列出了支持组合框控件所需的 UI 自动化事件。 有关事件的详细信息，请参阅 UI 自动化事件概述。

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

 

概念

UI 自动化控件类型概述

UI 自动化概述