共用方式為


實作 UI 自動化 Table 控制項模式

注意

本文件適用對象為 .NET Framework 開發人員,其想要使用 System.Windows.Automation 命名空間中定義的受控 UI 自動化類別。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:UI 自動化

本主題簡介實作 ITableProvider的方針和慣例,包括屬性、方法和事件的相關資訊。 其他參考的連結會在概觀的結尾列出。

TablePattern 控制項模式是用以支援當作子項目集合的容器使用的控制項。 此項目的子系必須實作 ITableItemProvider ,並組合管理成資料列與資料行可周遊的二維邏輯座標系統。 此控制項模式類似 IGridProvider,相反地,任何實作 ITableProvider 的控制項也必須公開每個子項目的資料行及 (或) 資料列標頭關聯性。 如需實作此控制項模式的控制項範例,請參閱 Control Pattern Mapping for UI Automation Clients

實作方針和慣例

實作表格控制項模式時,請注意下列方針和慣例:

  • 透過二維邏輯座標系統或必要 IGridProvider 並行實作所提供的陣列,才可存取個別資料格的內容。

  • 資料行或資料列標頭可以包含在資料表物件中,也可以是與資料表物件建立關係的個別標頭物件。

  • 資料行和資料列標頭可同時包含主要標頭和任何支援的標頭。

注意

此概念在使用者已定義「名字」資料行的 Microsoft Excel 試算表中格外明顯。 此資料行現在有兩個標頭—使用者定義的「名字」標頭和應用程式指派給該資料行的英數字元指定。

Table with complex header items. 具有複雜資料行標頭的資料表範例

Table with ambiguous RowOrColumnMajor property. 具有模稜兩可之 RowOrColumnMajor 屬性的資料表範例

ITableProvider 的必要成員

ITableProvider 介面需要下列屬性和方法。

必要成員 成員類型 備註
RowOrColumnMajor 屬性
GetColumnHeaders 方法
GetRowHeaders 方法

此控制項模式沒有任何相關聯的事件。

例外狀況

此控制項模式沒有任何相關聯的例外狀況。

另請參閱