Implementieren des Table-Steuerelementmusters der Benutzeroberflächenautomatisierung

  • Artikel

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieses Thema enthält Richtlinien und Konventionen für das Implementieren von ITableProvider, einschließlich Informationen über Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Referenzen sind am Ende dieser Übersicht aufgelistet.

Das TablePattern -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 ITableItemProvider implementieren und in einem zweidimensionalen logischen Koordinatensystem angeordnet sein, das zeilen- und spaltenweise durchlaufen werden kann. Dieses Steuerelementmuster entspricht dem IGridProvider, mit dem Unterschied, dass jedes ITableProvider implementierende Steuerelement für jedes untergeordnete Element auch eine Beziehung zwischen Spalten- und/oder Zeilenüberschriften verfügbar machen muss. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Control Pattern Mapping for UI Automation Clients.

Implementierungsrichtlinien und -konventionen

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

  • Der Zugriff auf den Inhalt der einzelnen Zellen erfolgt über ein zweidimensionales logisches Koordinatensystem oder über ein Array, das von der erforderlichen gleichzeitigen Implementierung von IGridProvider bereitgestellt wird.

  • Eine Spalten- oder Zeilenüberschrift kann in einem Tabellenobjekt enthalten sein oder ein separates Headerobjekt darstellen, das einem Tabellenobjekt zugeordnet ist.

  • Spalten- und Zeilenüberschriften können sowohl eine primäre als auch beliebige unterstützende Überschriften enthalten.

Hinweis

Dieses Konzept wird in einer Microsoft Excel-Kalkulationstabelle augenscheinlich, in der ein Benutzer die Spalte „Vorname“ definiert hat. Diese Spalte verfügt jetzt über zwei Überschriften. Die vom Benutzer definierte Überschrift „Vorname“ und die alphanumerische Bezeichnung der Spalte, die von der Anwendung zugewiesen wird.

Table with complex header items. Beispiel für eine Tabelle mit komplexen Spaltenüberschriften

Table with ambiguous RowOrColumnMajor property. Beispiel für eine Tabelle mit mehrdeutiger RowOrColumnMajor-Eigenschaft

Erforderliche Member für ITableProvider

Für die ITableProvider-Schnittstelle werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member Memberart Hinweise
RowOrColumnMajor Eigenschaft Keine
GetColumnHeaders Methode Keine
GetRowHeaders Methode Keine

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Diesem Steuerelementmuster sind keine Ausnahmen zugeordnet.

Weitere Informationen