Benutzeroberflächenautomatisierungs-Unterstützung für den Table-Steuerelementtyp

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.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Table-Steuerelementtyp. Bei der UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Table-Steuerelemente enthalten Textzeilen und -spalten sowie optional Zeilen- und Spaltenheader.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Table-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Table-Steuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.

Dieses Thema enthält folgende Abschnitte.

Erforderliche Benutzeroberflächenautomatisierungs-Struktur
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Table-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Tabelle Header (0 oder 1) Text (0 oder 1) Verschiedene Steuerelemente (beliebige Anzahl)	Tabelle Text (beliebige Anzahl) Verschiedene Steuerelemente (beliebige Anzahl)

Tabelle

Header (0 oder 1)
Text (0 oder 1)
Verschiedene Steuerelemente (beliebige Anzahl)

Tabelle

Text (beliebige Anzahl)
Verschiedene Steuerelemente (beliebige Anzahl)

Wenn ein Table-Steuerelement Zeilen- oder Spaltenheader besitzt, müssen sie in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur verfügbar gemacht werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da mit dem TablePattern auf sie zugegriffen werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für Table-Steuerelemente besonders relevant ist. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	Siehe Hinweise.	Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Das Table-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, müssen Sie eine Name-Eigenschaft zuweisen, die immer verfügbar sein muss, um den Zweck der Tabelle zu erläutern.
LabeledByProperty	Siehe Hinweise.	Wenn eine statische Textbezeichnung vorhanden ist, sollte diese Eigenschaft einen Verweis auf das Automatisierungselement dieses Steuerelements verfügbar machen.
ControlTypeProperty	Tabelle	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"table"	Lokalisierte Zeichenfolge für den Table-Steuerelementtyp.
HelpTextProperty	Siehe Hinweise.	Über diese Eigenschaft sollten weitere Details über den Zweck der Tabelle verfügbar gemacht werden, wenn er nicht durch Zugriff auf die NameProperty ausreichend erläutert wird.
DescribedByProperty()	Siehe Hinweise.	Wenn die Tabelle von einem anderen Benutzeroberflächenelement kommentiert wird (z. B. von einem Textelement, das die Beschreibung für die Tabelle enthält), sollte die DescribedBy-Eigenschaft einen Verweis auf das Automatisierungselement des Textsteuerelements verfügbar machen.
IsContentElementProperty	True	Das Table-Steuerelement muss stets ein Inhaltselement sein.
IsControlElementProperty	True	Das Table-Steuerelement muss stets ein Steuerelement sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Table-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster	Unterstützung	Hinweise
IGridProvider	Ja	Das Table-Steuerelement unterstützt immer dieses Steuerelementmuster, da die enthaltenen Elemente über Daten verfügen, die in einem Raster dargestellt werden.
IGridItemProvider	Ja (erforderlich bei untergeordneten Objekten)	Die inneren Objekte einer Tabelle sollten das GridItem-Steuerelementmuster und das TableItem-Steuerelementmuster unterstützen. Die Tabelle selbst muss das GridItem-Steuerelementmuster oder das TableItem-Steuerelementmuster nicht unterstützen, es sei denn, die Tabelle ist Teil einer anderen Tabelle.
ITableProvider	Ja	Das Table-Steuerelement verfügt immer über die Fähigkeit, dem Inhalt zugeordnete Header zu haben.
ITableItemProvider	Ja (erforderlich bei untergeordneten Objekten)	Die inneren Objekte einer Tabelle sollten das GridItem-Steuerelementmuster und das TableItem-Steuerelementmuster unterstützen. Die Tabelle selbst muss das GridItem-Steuerelementmuster oder das TableItem-Steuerelementmuster nicht unterstützen, es sei denn, die Tabelle ist Teil einer anderen Tabelle.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen Table-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

Table

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Freigeben über