Implementieren des Grid-Steuerelementmusters der Benutzeroberflächenautomatisierung

Artikel
08/10/2011

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von IGridProvider vorgestellt und Eigenschaften, Methoden sowie Ereignisse erläutert. Am Ende der Übersicht finden Sie Links zu zusätzlichen Verweisen.

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 Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

Implementierungsrichtlinien und Konventionen
Erforderliche Member für IGridProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

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

Grid-Koordinaten sind nullbasiert, wobei die obere linke Zelle (oder die obere rechte Zelle, je nach Gebietsschema) die Koordinaten (0,0) aufweist.
Auch wenn eine Zelle leer ist, muss ein Benutzeroberflächenautomatisierungselement zurückgegeben werden, um die ContainingGrid-Eigenschaft dieser Zelle zu unterstützen. Dies ist möglich, wenn das Layout von untergeordneten Elementen im Grid-Steuerelement dem eines unregelmäßigen Arrays entspricht (siehe folgendes Beispiel).

Beispiel für ein Grid-Steuerelement mit leeren Koordinaten

Windows Explorer-Ansicht mit Flatterlayout.

Ein Grid-Steuerelement mit einem einzelnen Element muss weiterhin IGridProvider implementieren, wenn es logisch als Raster gilt. Die Anzahl untergeordneter Elemente im Raster ist unwesentlich.
Ausgeblendete Zeilen und Spalten können je nach der Anbieterimplementierung in der UI Automation-Struktur geladen werden. Daher werden sie in den Eigenschaften RowCount und ColumnCount angegeben. Wenn die ausgeblendeten Zeilen und Spalten noch nicht geladen wurden, sollten sie nicht gezählt werden.
IGridProvider ermöglicht keine aktive Bearbeitung eines Grid-Steuerelements. ITransformProvider muss implementiert werden, um diese Funktionalität zu aktivieren.
Verwenden Sie einen StructureChangedEventHandler, um Änderungen an der Struktur oder am Layout des Grid-Steuerelements zu erfassen, z. B. Zellen, die hinzugefügt, entfernt oder zusammengeführt wurden.
Verwenden Sie einen AutomationFocusChangedEventHandler, um den Durchlauf durch die Elemente oder Zellen eines Grid-Steuerelements zu verfolgen.

Erforderliche Member für IGridProvider

Zum Implementieren der IGridProvider-Schnittstelle werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member	Typ	Hinweise
RowCount	Eigenschaft	Keine
ColumnCount	Eigenschaft	Keine
GetItem	Methode	Keine

Dieses Steuerelementmuster verfügt über keine zugeordneten Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	GetItem Wenn die angeforderte Zeilenkoordinate größer als RowCount ist oder die Spaltenkoordinate größer als ColumnCount ist.
ArgumentOutOfRangeException	GetItem Wenn eine der beiden angeforderten Zeilen- oder Spaltenkoordinaten kleiner als 0 (null) ist.

ArgumentOutOfRangeException

GetItem