Freigeben über


Typ des Tabellensteuerelements

Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Table-Steuerelementtyp.

Tabellensteuerelemente enthalten Zeilen und Spalten mit Text und optional Zeilen- und Spaltenüberschriften.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Table-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Tabellensteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Tabellensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Tabelle
    • Text (0 oder 1)
    • Header (0 oder mehr)
    • Verschiedene Steuerelemente (0 oder mehr)
  • Tabelle
    • Text (1 oder mehr)
    • Verschiedene Steuerelemente (0 oder mehr)

 

Wenn ein Tabellensteuerelement über Zeilen- oder Spaltenüberschriften verfügt, müssen diese in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur verfügbar gemacht werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da mit IUIAutomationTablePattern darauf zugegriffen werden kann.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für Tabellensteuerelemente besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId Tabelle
UIA_DescribedByPropertyId Siehe Hinweise. Wenn die Tabelle von anderen Benutzeroberflächenelementen (z. B. von einem Textelement, das die Beschreibung für die Tabelle enthält) mit Anmerkungen versehen ist, sollte die „DescribedBy“-Eigenschaft einen Verweis auf das Automatisierungselement des Textsteuerelements verfügbar machen.
UIA_HelpTextPropertyId Siehe Hinweise. Weitere Details zum Zweck der Tabelle sollten über diese Eigenschaft verfügbar gemacht werden, wenn dies durch die UIA_NamePropertyId-Eigenschaft nicht ausreichend erklärt wird.
UIA_IsContentElementPropertyId TRUE Das Tabellensteuerelement muss immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur angezeigt werden.
UIA_IsControlElementPropertyId TRUE Das Tabellensteuerelement muss immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur angezeigt werden.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId Siehe Hinweise. Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das Automatisierungselement des Steuerelements verfügbar machen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Table-Steuerelementtyp entspricht. Der Standardwert ist "table" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Das Tabellensteuerelement ruft in der Regel den Wert für seinen Namen aus einer statischen Textbeschriftung ab. Wenn keine statische Textbeschriftung vorhanden ist, muss das Element eine Name-Eigenschaft zuweisen, die immer verfügbar sein muss, um den Zweck der Tabelle zu erläutern.

 

Erforderliche Steuerelementmuster

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

Steuerelementmuster Support Notizen
IGridProvider Erforderlich Da das Tabellensteuerelement Elemente enthält, die in einem Raster dargestellt werden, unterstützt es immer das Raster-Steuerelementmuster.
IGridItemProvider Erforderlich für untergeordnete Objekte Die inneren Objekte einer Tabelle sollten sowohl das GridItem- als auch das 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 Erforderlich Das Tabellensteuerelement kann immer Header aufweisen, die dem Inhalt zugeordnet sind.
ITableItemProvider Erforderlich bei untergeordneten Objekten Die inneren Objekte einer Tabelle sollten sowohl das GridItem- als auch das 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 Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Tabellensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung