Raster-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von IGridProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Das Grid-Steuerelementmusters 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 werden, das nach Zeile und Spalte durchlaufen werden kann. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.

Dieses Thema enthält die folgenden Abschnitte.

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für IGridProvider-
• Verwandte Themen

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Grid- Steuerelementmusters die folgenden Richtlinien und Konventionen:

• Rasterkoordinaten sind nullbasiert mit der oberen linken (oder oberen rechten Zelle je nach Gebietsschema) mit Koordinaten (0,0).

• Wenn eine Zelle leer ist, muss weiterhin ein Microsoft-Benutzeroberflächenautomatisierungs-Element zurückgegeben werden, um die IGridItemProvider::ContainingGrid-Eigenschaft für diese Zelle zu unterstützen. Dies ist möglich, wenn das Layout untergeordneter Elemente im Raster mit einem markierten Array vergleichbar ist (siehe Beispiel unten).

  

• Ein Raster mit einem einzelnen Element ist weiterhin erforderlich, um IGridProvider zu implementieren, wenn es logisch als Raster angesehen wird. Die Anzahl der untergeordneten Elemente im Raster ist unwesentlich.

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

• IGridProvider- aktiviert keine aktive Manipulation eines Rasters; ITransformProvider- muss implementiert werden, um diese Funktionalität zu aktivieren.

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

• Verwenden Sie eine IUIAutomationFocusChangedEventHandler-, um das Durchlaufen der Elemente oder Zellen eines Rasters nachzuverfolgen.

Erforderliche Elemente für IGridProvider-

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

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Verwandte Themen

Steuerelementtypen und deren unterstützte Steuerelementmuster

GridItem-Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur