实现 UI 自动化 Table 控件模式

注意

本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化

本主题介绍实现 ITableProvider的准则和约定,包括有关属性、方法和事件的信息。 本概述的结尾列出了指向其他参考资料的链接。

TablePattern 控件模式用于支持作为子元素集合的容器的控件。 此元素的子元素必须实现 ITableItemProvider ,并且在可以按行和列进行遍历的二维逻辑坐标系统中进行组织。 此控件模式类似于 IGridProvider,区别在于任何实现 ITableProvider 的控件都还必须公开每个子元素的列和/或行标头关系。 有关实现此控件模式的控件示例,请参阅 Control Pattern Mapping for UI Automation Clients

实现准则和约定

在实现 Table 控件模式时,请注意以下准则和约定:

  • 对个别单元格的内容的访问是通过二维逻辑坐标系统或由所需的 IGridProvider 的并发实现提供的数组来实现。

  • 列或行标头可包含在表对象中或可以为与表对象相关联的单独标头对象。

  • 列和行标头可能包含主标头以及任何支持的标头。

注意

这一概念在 Microsoft Excel 电子表格中变得显而易见,一个用户已在表格中定义了“名字”列。 此列现在有两个标头 — 用户定义的“名字”标头和应用程序分配的该列的字母数字名称。

Table with complex header items. 具有复杂列标头的表示例

Table with ambiguous RowOrColumnMajor property. 具有不明确的 RowOrColumnMajor 属性的表示例

ITableProvider 必需的成员

ITableProvider 接口需要以下属性和方法。

必需的成员 成员类型 说明
RowOrColumnMajor 属性
GetColumnHeaders 方法
GetRowHeaders 方法

没有与此控件模式关联的事件。

例外

没有与此控件模式关联的异常。

请参阅