Freigeben über


Implementieren des Table-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 ITableProvidervorgestellt, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Verweisen werden am Ende der Übersicht aufgeführt.

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 ist analog zu IGridProvider, mit dem Unterschied, dass jedes Steuerelement, das ITableProvider implementiert, auch eine Spalten- und/oder Zeilenkopfbeziehung für jedes untergeordnete Element verfügbar machen muss. 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 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 Kopfzeilenobjekt sein, das einem Tabellenobjekt zugeordnet ist.

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

Hinweis

Dieses Konzept wird in einer Microsoft Excel-Kalkulationstabelle deutlich, in der ein Benutzer eine Spalte "Vorname" definiert hat. Diese Spalte verfügt nun über zwei Überschriften: die vom Benutzer definierte Kopfzeile "Vorname" und die alphanumerische Bezeichnung für diese Spalte, die der Anwendung zugewiesen wurde.

Tabelle mit komplexen Kopfzeilenelementen. Beispiel für eine Tabelle mit komplexen Spaltenüberschriften

Tabelle mit mehrdeutiger RowOrColumnMajor-Eigenschaft. Beispiel für eine Tabelle mit mehrdeutiger RowOrColumnMajor-Eigenschaft

Notwendige Mitglieder für ITableProvider

Die folgenden Eigenschaften und Methoden sind für die ITableProvider-Schnittstelle erforderlich.

Erforderliche Mitglieder Elementtyp Hinweise
RowOrColumnMajor Eigentum Nichts
GetColumnHeaders Methode Nichts
GetRowHeaders Methode Nichts

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Ausnahmen

Diesem Steuerelementmuster sind keine Ausnahmen zugeordnet.

Siehe auch