共用方式為


網格線控件模式

說明實作 IGridProvider的指導方針和慣例,包括屬性和方法的相關信息。 Grid 控制項模式可用來支援做為子元素集合容器的控制件。

這個專案的子系必須實作 IGridItemProvider,並組織在二維邏輯座標系統中,以數據列和數據行周遊。 如需實作此控制項模式的控制項範例,請參閱 控制項類型和其支援的控制項模式

本主題包含下列各節。

實作指導方針和慣例

實作 方格 控件模式時,請注意下列指導方針和慣例:

  • 網格線座標是以零為基底,具有座標(0,0)的左上方(或右上方單元格視地區設定而定)。

  • 如果單元格是空的,仍必須傳回Microsoft UI Automation 元素,才能支援該單元格的 IGridItemProvider::ContainingGrid 屬性。 當方格中的子元素配置類似於不完全的陣列時,就可能發生這種情況(請參閱下面的範例)。

    具有空白座標的網格線控件 範例

  • 如果以邏輯方式將 IGridProvider 視為方格,仍然需要具有單一專案的方格來實作 IGridProvider。 方格中的子項目數目不重要。

  • 視提供者實作而定,隱藏的數據列和數據行可能會載入UI自動化樹狀結構中,因此會反映在IGridProvider::RowCountColumnCount 屬性中。 如果尚未載入隱藏的數據列和數據行,則不應該計算它們。

  • IGridProvider 不會啟用網格線的作用中作;必須實作 ITransformProvider,才能啟用此功能。

  • 使用 IUIAutomationStructureChangedEventHandler 接聽網格線的結構或版面配置變更,例如已新增、移除或合併的單元格。

  • 使用 IUIAutomationFocusChangedEventHandler 追蹤網格線專案或單元格的周遊。

IGridProvider 的必要成員

實作 IGridProvider介面需要下列屬性和方法。

必要成員 成員類型 筆記
RowCount 財產 沒有
ColumnCount 財產 沒有
GetItem 方法 沒有

 

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

控件類型及其支援的控制模式

GridItem 控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀結構概觀