UI 自动化对 CheckBox 控件类型的支持
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍了 Microsoft UI 自动化对 CheckBox 控件类型的支持。 在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括针对 UI 自动化树结构、UI 自动化属性值和控件模式的特定准则。
复选框是一种用于指示状态的对象，用户可与之交互来循环切换该状态。 复选框将向用户呈现二元（是/否或开启/关闭）或者三元（开启、关闭、不确定）选项。
以下部分定义 CheckBox 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于所有 CheckBox 控件，无论是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。
必需的 UI 自动化树结构
下表描述与 CheckBox 控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。
| 控件视图 | 内容视图 |
|---|---|
| CheckBox | CheckBox |
备注
复选框在控件或内容视图中决不会具有子元素。 如果控件确实需要包含子元素，则表明应当使用另一种控件类型。
必需的 UI 自动化属性
下表列出值或定义与 CheckBox 控件特别相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息，请参阅客户端的 UI 自动化属性。
| UI 自动化属性 | 值 | 说明 |
|---|---|---|
| AutomationIdProperty | 请参阅注释。 | 此属性的值在应用程序的所有控件中都必须保持唯一。 |
| BoundingRectangleProperty | 请参阅注释。 | 包含整个控件的最外层矩形。 |
| ClickablePointProperty | 请参阅注释。 | 如果存在边界矩形，则受支持。 如果边界矩形中存在无法单击的点，而你要执行专门的命中测试，则重写并提供可单击的点。 |
| ControlTypeProperty | CheckBox | 此值对于所有 UI 框架均相同。 |
| IsContentElementProperty | 正确 | 此属性的值必须始终为 True。 这意味着 CheckBox 控件必须始终包含在 UI 自动化树的内容视图中。 |
| IsControlElementProperty | 正确 | 此属性的值必须始终为 True。 这意味着 CheckBox 控件必须始终包含在 UI 自动化树的控件视图中。 |
| IsKeyboardFocusableProperty | 请参阅注释。 | 如果该控件可以接收键盘焦点，则它必须支持此属性。 |
| LabeledByProperty | Null |
复选框控件自行进行标记。 |
| LocalizedControlTypeProperty | “复选框” | 与 CheckBox 控件类型相对应的本地化字符串。 |
| NameProperty | 请参阅注释。 | 复选框控件的 Name 属性的值是显示在保持切换状态的框旁边的文本。 |
必需的 UI 自动化控件模式
下表列出了需要由所有 CheckBox 控件支持的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。
| 控件模式 | 支持 | 说明 |
|---|---|---|
| IToggleProvider | 必须 | 允许通过编程方式使复选框循环切换其内部状态。 |
必需的 UI 自动化事件
下表列出了需要由所有 CheckBox 控件支持的 UI 自动化事件。 有关事件的详细信息，请参阅 UI Automation Events Overview。
| UI 自动化事件 | 支持 | 说明 |
|---|---|---|
| AutomationFocusChangedEvent | 必须 | 无 |
| BoundingRectangleProperty 属性更改事件。 | 必需 | 无 |
| IsOffscreenProperty 属性更改事件。 | 必需 | 无 |
| IsEnabledProperty 属性更改事件。 | 必需 | 无 |
| StructureChangedEvent | 必须 | 无 |
| ToggleStateProperty 属性更改事件。 | 必需 | 无 |
默认操作
复选框的默认操作是使单选按钮获得焦点并切换其当前状态。 如前所述，复选框将向用户呈现二元（是/否或开启/关闭）或者三元（开启、关闭、不确定）选项。 如果复选框是二元复选框，则默认操作会使“开启”状态变为“关闭”，或使“关闭”状态变为“开启”。 在三元状态复选框中，默认操作会按相同的顺序循环切换复选框的状态，就好像用户用鼠标连续单击控件一样。