UI 自动化对 ComboBox 控件类型的支持
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍 UI 自动化对于 ComboBox 控件类型的支持信息。 在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括针对 UI 自动化树结构、UI 自动化属性值、控件模式和 UI 自动化事件的特定准则。
组合框是与静态控件或编辑控件组合在一起的列表框，静态控件或编辑控件在组合框的列表框部分中显示了当前选定的项目。 控件的列表框部分要么将始终显示出来，要么只有当用户选择控件旁边的下拉箭头（下压按钮）时才会出现。 如果选择字段是一个编辑控件，则用户可以输入列表外的信息；否则，用户只能选择列表中的项目。
以下部分定义 ComboBox 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于所有 ComboBox 控件，无论是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。
必需的 UI 自动化树结构
下表描述与组合框控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。
| 控件视图 | 内容视图 |
|---|---|
| ComboBox - Edit（0 个或 1 个） - List（1 个） - List Item（列表的子项；0 到多个） - Button（1 个） |
ComboBox - List Item（0 到多个） |
只有在能够编辑组合框以接纳任何输入的情况下，组合框控件视图中的编辑控件才是必需的，“运行”对话框中的组合框也是如此。
必需的 UI 自动化属性
下表列出值或定义与组合框控件特别相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息，请参阅客户端的 UI 自动化属性。
| UI 自动化属性 | 值 | 说明 |
|---|---|---|
| AutomationIdProperty | 请参阅注释。 | 此属性的值在应用程序的所有控件中都必须保持唯一。 |
| BoundingRectangleProperty | 请参阅注释。 | 包含整个控件的最外层矩形。 |
| ClickablePointProperty | 请参阅注释。 | 如果存在边界矩形，则受支持。 如果边界矩形中存在无法单击的点，而你要执行专门的命中测试，则重写并提供可单击的点。 |
| ControlTypeProperty | ComboBox | 此值对于所有 UI 框架均相同。 |
| HelpTextProperty | 请参阅注释。 | 组合框控件的帮助文本应解释为什么要求用户从组合框中选择一个选项。 文本与通过工具提示呈现的信息类似。 例如，“选择一个项来为你的监视器设置显示分辨率。” |
| IsContentElementProperty | 正确 | 组合框控件始终包含在 UI 自动化树的内容视图中。 |
| IsControlElementProperty | 正确 | 组合框控件始终包含在 UI 自动化树的控件视图中。 |
| IsKeyboardFocusableProperty | 正确 | 组合框控件将公开选择容器中的一组项。 组合框控件可以接收键盘焦点，但 UI 自动化客户端在组合框上设置焦点时，组合框子树中的任何项都可以接收焦点。 |
| LabeledByProperty | 请参阅注释。 | 组合框控件通常具有此属性引用的静态文本标签。 |
| LocalizedControlTypeProperty | “组合框” | 与 ComboBox 控件类型相对应的本地化字符串。 |
| NameProperty | 请参阅注释。 | 组合框控件通常从静态文本控件获取其名称。 |
必需的 UI 自动化控件模式
下表列出了需要由所有组合框控件支持的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。
| 控件模式 | 支持 | 说明 |
|---|---|---|
| IExpandCollapseProvider | 是 | 组合框控件必须始终包含下拉按钮才能成为组合框。 |
| ISelectionProvider | 是 | 显示组合框中的当前选择。 将委托组合框下面的列表框提供此支持。 |
| IValueProvider | 依赖的对象 | 如果组合框能够接受任意文本值，则必须支持 Value 模式。 这种模式可以提供以编程方式设置组合框字符串内容的功能。 如果不支持 Value 模式，则表示用户必须从组合框子树内的列表项中进行选择。 |
| IScrollProvider | 从不 | 组合框上从不直接支持 Scroll 模式。 如果组合框内包括的列表框可以滚动，则支持此模式。 只有在屏幕上可以看到列表框时才支持此模式。 |
必需事件
下表列出了需要由所有组合框控件支持的 UI 自动化事件。 有关事件的详细信息，请参阅 F:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty。
| UI 自动化事件 | 支持 | 说明 |
|---|---|---|
| AutomationFocusChangedEvent | 必须 | 无 |
| BoundingRectangleProperty 属性更改事件。 | 必需 | 无 |
| IsOffscreenProperty 属性更改事件。 | 必需 | 无 |
| IsEnabledProperty 属性更改事件。 | 必需 | 无 |
| StructureChangedEvent | 必须 | 无 |
| ExpandCollapseStateProperty 属性更改事件。 | 必需 | 无 |
| ValueProperty 属性更改事件。 | 依赖的对象 | 如果控件支持 Value 模式，则它必须支持此事件。 |