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

更新：2007 年 11 月

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

组控件表示层次结构中的一个节点。Group 控件类型在 UI 自动化树中创建了一种分隔机制，以便 UI 自动化树中组合在一起的项具有逻辑划分。

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

本主题包括下列各节。

必需的 UI 自动化树结构

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

控件视图	内容视图
Group 0 个或多个控件	Group 0 个或多个控件

通常，子树中组控件的下面将具有 UI 自动化对 ListItem 控件类型的支持、UI 自动化对 TreeItem 控件类型的支持或 UI 自动化对 DataItem 控件类型的支持控件类型。由于“Group”是一个泛型容器，因此树中 Group 控件的下面可以有任何类型的控件。

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

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值必须在应用程序中的所有控件中保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	有边框时支持。如果边框中并非每个点都是可单击的，那么，在执行专用的命中测试时，请重写并提供一个可单击的点。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	组控件通常从用来对该控件进行标记的文本获取其名称。
LabeledByProperty	请参见“说明”。	组控件通常自行进行标记。在这里，将在这些情况下返回 null。如果该组有一个静态文本标签，则该属性必须作为 LabeledBy 属性的值返回。
ControlTypeProperty	Group	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	“组”	与 Group 控件类型相对应的本地化字符串。
IsContentElementProperty	True	组控件始终包括在 UI 自动化树的内容视图中。
IsControlElementProperty	True	日历组始终包括在 UI 自动化树的控件视图中。

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

控件模式/模式属性	支持/值	说明
IExpandCollapseProvider	视情况而定	可用来显示或隐藏信息的组控件必须支持 Expand Collapse 模式。

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

UI 自动化事件	支持	说明
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	必需	无
ExpandCollapseStateProperty property-changed 事件。	视情况而定	无
ToggleStateProperty property-changed 事件。	视情况而定	无
AutomationFocusChangedEvent	必需	无
StructureChangedEvent	必需	无