Freigeben über

Implementieren des Grid-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung von IGridProvidervorgestellt, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Verweisen werden am Ende der Übersicht aufgeführt.

Das GridPattern -Steuerelementmuster wird zur Unterstützung von Steuerelementen verwendet, die als Container für eine Auflistung von untergeordneten Elementen dienen. Die untergeordneten Elemente dieses Elements müssen IGridItemProvider implementieren und in einem zweidimensionalen logischen Koordinatensystem angeordnet sein, das zeilen- und spaltenweise durchlaufen werden kann. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

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

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

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

Windows Explorer-Ansicht mit zerklüftetem Layout. Beispiel für ein Rastersteuerelement mit leeren Koordinaten

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

  • Je nach Anbieterimplementierung können ausgeblendete Zeilen und Spalten im UI-Automatisierungsbaum geladen werden und werden daher in den RowCount- und ColumnCount-Eigenschaften wiedergegeben. 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 StructureChangedEventHandler , um strukturelle oder Layoutänderungen am Raster zu überwachen, z. B. Zellen, die hinzugefügt, entfernt oder zusammengeführt wurden.

  • Verwenden Sie einen AutomationFocusChangedEventHandler , um den Durchlauf durch die Elemente oder Zellen eines Rasters zu verfolgen.

Erforderliche Mitglieder für IGridProvider

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

Erforderliche Mitglieder Typ Hinweise
RowCount Eigentum Nichts
ColumnCount Eigentum Nichts
GetItem Methode Nichts

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Zustand
ArgumentOutOfRangeException GetItem

- Wenn die angeforderte Zeilenkoordinate größer als die RowCount oder die Spaltenkoordinate größer als die ColumnCount ist.
ArgumentOutOfRangeException GetItem

- Wenn eine der angeforderten Zeilen- oder Spaltenkoordinaten kleiner als Null ist.

Siehe auch

  • Last updated on