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