注释
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题提供有关 ComboBox 控件类型的 UI 自动化支持的信息。 在 UI 自动化中，控件类型是控件为了使用属性 ControlTypeProperty 而必须满足的一组条件。 这些条件包括 UI 自动化树结构、UI 自动化属性值、控件模式和 UI 自动化事件的特定准则。
组合框是一个列表框，它与静态控件或编辑控件组合在组合框的列表框部分显示当前选定的项。 控件的列表框部分随时显示，或者仅当用户选择控件旁边的下拉箭头（即按下按钮）时显示。 如果选择字段是编辑控件，则用户可以输入不在列表中的信息;否则，用户只能选择列表中的项。
以下部分定义了 ComboBox 控件类型的所需 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于所有组合框控件，无论是 Windows Presentation Foundation （WPF）、Win32 还是 Windows 窗体。
必需的 UI 自动化树结构
下表描述了与组合框控件相关的 UI 自动化树的控件视图和内容视图，并描述了每个视图中可包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。
| 控件视图 | 内容视图 |
|---|---|
| ComboBox - 编辑 （0 或 1） - List（1 个） - List Item（列表的子项；0 到多个） - 按钮 （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 自动化控件模式概述。
| 控件模式 | 支持 | 注释 |
|---|---|---|
| IExpandCollapseProvider | 是的 | 组合框控件必须始终包含下拉按钮才能成为组合框。 |
| ISelectionProvider | 是的 | 在组合框中显示当前选定内容。 将委托组合框下面的列表框提供此支持。 |
| IValueProvider | 取决于 | 如果组合框能够采用任意文本值，则必须支持值模式。 此模式提供以编程方式设置组合框的字符串内容的功能。 如果不支持“值”模式，则表示用户必须从组合框的子树中的列表项中进行选择。 |
| IScrollProvider | 从不 | 组合框上从不直接支持 Scroll 模式。 如果组合框中包含的列表框可以滚动，则支持它。 仅当列表框在屏幕上可见时，它才可能受支持。 |
必需事件
以下表格列出了所有组合框控件必须支持的 UI 自动化事件。 有关事件的详细信息，请参阅 UI 自动化事件概述。
| UI 自动化事件 | 支持 | 注释 |
|---|---|---|
| AutomationFocusChangedEvent | 必选 | 没有 |
| BoundingRectangleProperty 属性更改事件。 | 必选 | 没有 |
| IsOffscreenProperty 属性更改事件。 | 必选 | 没有 |
| IsEnabledProperty 属性更改事件。 | 必选 | 没有 |
| StructureChangedEvent | 必选 | 没有 |
| ExpandCollapseStateProperty 属性更改事件。 | 必选 | 没有 |
| ValueProperty 属性更改事件。 | 取决于 | 如果控件支持 Value 模式，则必须支持此事件。 |