網格線控件模式
說明實作 IGridProvider的指導方針和慣例,包括屬性和方法的相關信息。 Grid 控制項模式可用來支援做為子元素集合容器的控制件。
這個專案的子系必須實作 IGridItemProvider,並組織在二維邏輯座標系統中,以數據列和數據行周遊。 如需實作此控制項模式的控制項範例,請參閱 控制項類型和其支援的控制項模式。
本主題包含下列各節。
實作指導方針和慣例
實作 方格 控件模式時,請注意下列指導方針和慣例:
網格線座標是以零為基底,具有座標(0,0)的左上方(或右上方單元格視地區設定而定)。
如果單元格是空的,仍必須傳回Microsoft UI Automation 元素,才能支援該單元格的 IGridItemProvider::ContainingGrid 屬性。 當方格中的子元素配置類似於不完全的陣列時,就可能發生這種情況(請參閱下面的範例)。
具有空白座標的網格線控件
如果以邏輯方式將 IGridProvider 視為方格,仍然需要具有單一專案的方格來實作 IGridProvider。 方格中的子項目數目不重要。
視提供者實作而定,隱藏的數據列和數據行可能會載入UI自動化樹狀結構中,因此會反映在IGridProvider::RowCount和 ColumnCount 屬性中。 如果尚未載入隱藏的數據列和數據行,則不應該計算它們。
IGridProvider 不會啟用網格線的作用中作;必須實作 ITransformProvider,才能啟用此功能。
使用 IUIAutomationStructureChangedEventHandler 接聽網格線的結構或版面配置變更,例如已新增、移除或合併的單元格。
使用 IUIAutomationFocusChangedEventHandler 追蹤網格線專案或單元格的周遊。
IGridProvider 的必要成員
實作 IGridProvider介面需要下列屬性和方法。
必要成員 | 成員類型 | 筆記 |
---|---|---|
RowCount | 財產 | 沒有 |
ColumnCount | 財產 | 沒有 |
GetItem | 方法 | 沒有 |
此控制件模式沒有相關聯的事件。
相關主題