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

更新：2007 年 11 月

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

Table 控件包含文本行和文本列，还可包含行标头和列标头。

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

本主题包括下列各节。

必需的 UI 自动化树结构

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

控件视图	内容视图
Table 标头（0 个或 1 个）文本（0 个或 1 个）	Table 文本（1 个或多个）

如果某个 Table 控件具有行标头或列标头，则必须在 UI 自动化树的控件视图中公开这些标头。内容视图不需要公开此信息，因为它可以使用 TablePattern 进行访问。

请注意，Table 元素的子树中始终至少有一个文本元素。

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

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值在应用程序的所有控件中必须保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	有边框时支持。如果并非边框中的每个点都是可单击的，那么，当您执行专用的命中测试时，请重写并提供一个可单击的点。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	Table 控件通常从静态文本标签获取其名称。如果没有静态文本标签，您必须分配一个必须始终可用于说明该表的用途的 Name 属性。
LabeledByProperty	请参见“说明”。	如果存在静态文本标签，则此属性必须公开对该控件的引用。
ControlTypeProperty	Table	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	"table"	与 Table 控件类型相对应的本地化字符串。
HelpTextProperty	""	如果通过访问 NameProperty 得不到有关表用途的足够说明信息，则应当通过该属性公开表用途的更多详细信息。
IsContentElementProperty	True	Table 控件必须始终为内容。
IsControlElementProperty	True	Table 控件必须始终为控件。

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

控件模式/模式属性	支持/值	说明
IGridProvider	是	Table 控件始终支持该控件模式，因为它包含的项具有在网格中演示的数据。
ITableProvider	Yes	Table 控件始终能够将标头与内容关联。
ITableItemProvider	视情况而定	如果文本元素包含在 Table 控件内，则必须支持此模式。

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

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