UI 自动化对 CheckBox 控件类型的支持

项目
09/04/2008

更新：2007 年 11 月

本主题介绍 Microsoft UI 自动化对 CheckBox 控件类型的支持。在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值和控件模式。

复选框是一种用于指示状态的对象，用户可与之交互来循环切换该状态。复选框将向用户呈现二元（是/否或开启/关闭）或者三元（开启、关闭、不确定）选项。

以下几节定义了 CheckBox 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有复选框控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。

本主题包括下列各节。

必需的 UI 自动化树结构
必需的 UI 自动化控件模式
必需的 UI 自动化事件
默认操作
相关主题

必需的 UI 自动化树结构

下表描述了与复选框控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。

控件视图	内容视图
CheckBox	CheckBox

说明：
复选框在控件或内容视图中决不会具有子元素。如果控件确实需要包含子元素，则表明应当使用另一种控件类型。

必需的 UI 自动化属性

下表列出了值或定义与复选框控件关系密切的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值在应用程序中的所有控件中必须保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	有边框时支持。如果并非边框中的每个点都是可单击的，那么，当您执行专用的命中测试时，请重写并提供一个可单击的点。
ControlTypeProperty	CheckBox	此值对于所有的 UI 框架均相同。
IsContentElementProperty	True	此属性的值必须始终为 True。这意味着复选框控件必须始终包括在 UI 自动化树的内容视图中。
IsControlElementProperty	True	此属性的值必须始终为 True。这意味着复选框控件必须始终包括在 UI 自动化树的控件视图中。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
LabeledByProperty	Null	复选框控件自行进行标记。
LocalizedControlTypeProperty	“复选框”	与 CheckBox 控件类型相对应的本地化字符串。
NameProperty	请参见“说明”。	复选框控件的 Name 属性的值是显示在保持切换状态的框旁边的文本。

必需的 UI 自动化控件模式

下表列出了必须由所有复选框控件支持的UI 自动化控件模式。有关控件模式的更多信息，请参见 UI 自动化控件模式概述。

控件模式/模式属性	支持/值	说明
IToggleProvider	必需	允许通过编程方式使复选框循环切换其内部状态。

必需的 UI 自动化事件

下表列出了必须由所有复选框控件支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。

UI 自动化事件	支持	说明
AutomationFocusChangedEvent	必需	无
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	必需	无
StructureChangedEvent	必需	无
ToggleStateProperty property-changed 事件。	必需	无

默认操作

复选框的默认操作是使单选按钮获得焦点并切换其当前状态。如前所述，复选框将向用户呈现二元（是/否或开启/关闭）或者三元（开启、关闭、不确定）选项。如果复选框是二元复选框，则默认操作会使“开启”状态变为“关闭”，或使“关闭”状态变为“开启”。在三元状态复选框中，默认操作会按相同的顺序循环切换复选框的状态，就好像用户用鼠标连续单击控件一样。