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