共用方式為


格線控制項模式

描述實作 IGridProvider的指導方針和慣例,包括屬性和方法的相關資訊。 Grid控制項模式是用來支援做為子項目集合容器的控制項。

此元素的子系必須實作 IGridItemProvider ,並組織在可依資料列和資料行周遊的二維邏輯座標系統中。 如需實作此控制項模式的控制項範例,請參閱 控制項類型及其支援的控制項模式

本主題包含下列各節。

實作方針和慣例

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

  • 格線座標是以零起始,根據地區設定) 具有座標 (0,0) ,以左上方 (或右上方儲存格為基礎。

  • 如果儲存格是空的,仍然必須傳回 Microsoft 消費者介面自動化 元素,才能支援該儲存格的IGridItemProvider::ContainingGrid屬性。 當子項目在方格中的配置類似不完全陣列 (請參閱以下範例),就可能發生這種情形。

    具有空白座標的格線控制項範例

  • 如果以邏輯方式將 IGridProvider 視為方格,仍然需要具有單一專案的方格。 方格中的子項目數為多少都沒關係。

  • 視提供者實作而定,隱藏的資料列和資料行可能會載入消費者介面自動化樹狀結構中,因此會反映在IGridProvider::RowCountColumnCount屬性中。 如果隱藏資料列和資料行未載入,則應不會列入計數。

  • IGridProvider 不會啟用格線的作用中操作;必須實作 ITransformProvider 才能啟用這項功能。

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

  • 使用 IUIAutomationFocusChangedEventHandler 來追蹤周遊格線的專案或儲存格。

IGridProvider的必要成員

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

必要成員 成員類型 備註
RowCount 屬性
ColumnCount 屬性
GetItem 方法

 

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

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

GridItem 控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀