Freigeben über


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

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.

Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Tabelle“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.

Table-Steuerelemente enthalten Zeilen und Spalten von Text sowie optional Zeilen- und Spaltenüberschriften.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Tabelle“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Tabellensteuerelemente unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Tabellensteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
Tabelle

– Header (0 oder 1)
– Text (0 oder 1)
– Verschiedene Steuerelemente (0 oder mehr)
Tabelle

– Text (0 oder mehr)
– Verschiedene Steuerelemente (0 oder mehr)

Wenn ein Table-Steuerelement Zeilen- oder Spaltenüberschriften aufweist, müssen sie in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur verfügbar gemacht werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da mithilfe von „TablePattern“ darauf zugegriffen werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für Tabellensteuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
AutomationIdProperty Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein.
BoundingRectangleProperty Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
ClickablePointProperty Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht auf jeden Punkt innerhalb des umschließenden Rechtecks geklickt werden kann, und Sie spezielle Treffertests ausführen, setzen Sie die Eigenschaft außer Kraft, und stellen Sie dann einen klickbaren Punkt bereit.
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 Bezeichnung 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, muss diese Eigenschaft einen Verweis auf das Automatisierungselement des Steuerelements verfügbar machen.
ControlTypeProperty Tabelle Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty "table" Lokalisierte Zeichenfolge für den Steuerelementtyp „Table“.
HelpTextProperty Siehe Hinweise. Weitere Informationen zum Zweck der Tabelle sollten über diese Eigenschaft verfügbar gemacht werden, wenn er durch den Zugriff auf „NameProperty“ nicht ausreichend erläutert wird.
IsContentElementProperty True Das Table-Steuerelement muss immer ein Inhaltselement sein.
IsControlElementProperty True Das Table-Steuerelement muss immer ein Steuerelement sein.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster

In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von Tabellensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IGridProvider Ja Das Table-Steuerelement unterstützt dieses Steuerelementmuster immer, da die in ihm enthaltenen Elemente Daten aufweisen, die in einem Raster dargestellt sind.
IGridItemProvider Ja (erforderlich bei untergeordneten Objekten) Die inneren Objekte einer Tabelle müssen das GridItem- und TableItem-Steuerelementmuster unterstützen. Die Tabelle selbst muss das GridItem- oder 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 Möglichkeit, dass seinem Inhalt Überschriften zugeordnet werden.
ITableItemProvider Ja (erforderlich bei untergeordneten Objekten) Die inneren Objekte einer Tabelle müssen das GridItem- und TableItem-Steuerelementmuster unterstützen. Die Tabelle selbst muss das GridItem- oder 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 Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Tabellensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Support Hinweise
Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. Erforderlich Keine
AutomationFocusChangedEvent Erforderlich Keine
StructureChangedEvent Erforderlich Keine

Siehe auch