實作 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 試算表中格外明顯。 此資料行現在有兩個標頭—使用者定義的「名字」標頭和應用程式指派給該資料行的英數字元指定。
- 如需相關的方格功能,請參閱實作 UI 自動化方格控制項模式。
具有複雜資料行標頭的資料表範例
具有模稜兩可之 RowOrColumnMajor 屬性的資料表範例
ITableProvider 的必要成員
ITableProvider 介面需要下列屬性和方法。
必要成員 | 成員類型 | 備註 |
---|---|---|
RowOrColumnMajor | 屬性 | 無 |
GetColumnHeaders | 方法 | 無 |
GetRowHeaders | 方法 | 無 |
此控制項模式沒有任何相關聯的事件。
例外狀況
此控制項模式沒有任何相關聯的例外狀況。