Freigeben über

Rastersteuerelementmuster

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von IGridProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das Grid-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die als Container für eine Sammlung untergeordneter Elemente fungieren.

Die untergeordneten Elemente dieses Elements müssen IGridItemProvider implementieren und in einem zweidimensionalen logischen Koordinatensystem organisiert sein, das nach Zeile und Spalte durchlaufen werden kann. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des Grid-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Rasterkoordinaten sind nullbasiert, wobei die obere linke (oder die obere rechte Zelle je nach Gebietsschema) Koordinaten (0,0) aufweist.

  • Wenn eine Zelle leer ist, muss weiterhin ein Microsoft Benutzeroberflächenautomatisierung-Element zurückgegeben werden, um die IGridItemProvider::ContainingGrid-Eigenschaft für diese Zelle zu unterstützen. Dies ist möglich, wenn das Layout von untergeordneten Elementen im Raster dem eines unregelmäßigen Arrays entspricht (siehe folgendes Beispiel).

    Beispiel für ein Rastersteuerelement mit leeren Koordinaten

  • Ein Raster mit einem einzelnen Element ist weiterhin erforderlich, um IGridProvider zu implementieren, wenn es logischerweise als Raster betrachtet wird. Die Anzahl untergeordneter Elemente im Raster ist unwesentlich.

  • Ausgeblendete Zeilen und Spalten können je nach Anbieterimplementierung in die Benutzeroberflächenautomatisierung-Struktur geladen werden und werden daher in den Eigenschaften IGridProvider::RowCount und ColumnCount widerspiegelt. Wenn die ausgeblendeten Zeilen und Spalten noch nicht geladen wurden, sollten sie nicht gezählt werden.

  • IGridProvider ermöglicht keine aktive Bearbeitung eines Rasters. ITransformProvider muss implementiert werden, um diese Funktionalität zu aktivieren.

  • Verwenden Sie einen IUIAutomationStructureChangedEventHandler , um auf strukturelle oder Layoutänderungen am Raster zu lauschen, z. B. auf Zellen, die hinzugefügt, entfernt oder zusammengeführt wurden.

  • Verwenden Sie einen IUIAutomationFocusChangedEventHandler , um den Durchlauf durch die Elemente oder Zellen eines Rasters nachzuverfolgen.

Erforderliche Member für IGridProvider

Die folgenden Eigenschaften und Methoden sind für die Implementierung der IGridProvider-Schnittstelle erforderlich.

Erforderliche Member Memberart Hinweise
Rowcount Eigenschaft Keine
Columncount Eigenschaft Keine
Getitem Methode Keine

 

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Steuerelementtypen und ihre unterstützten Steuerelementmuster

GridItem-Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur