Tabellensteuersteuertyp

Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung-Unterstützung für den Tabellensteuertyp.

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

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

Dieses Thema enthält folgende Abschnitte:

Typische Strukturstruktur

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

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 Tabellensteuer steuerelement Zeilen- oder Spaltenüberschriften enthält, müssen sie in der Steuerelementansicht der Benutzeroberflächenautomatisierung werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da auf sie mithilfe von IUIAutomationTablePattern zugegriffen werden kann.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für Tabellensteuerelemente besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung 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 rohen Ansicht der Benutzeroberflächenautomatisierung 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 umgebundenen Rechtecks angeklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Und stellen Sie einen klickbaren Punkt zur Verfügung.
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 Informationen zum Zweck der Tabelle sollten über diese Eigenschaft verfügbar gemacht werden, wenn sie nicht ausreichend durch die Eigenschaft UIA _ NamePropertyId erläutert wird.
UIA _ IsContentElementPropertyId TRUE Das Tabellensteuer steuerelement muss immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung werden.
UIA _ IsControlElementPropertyId TRUE Das Tabellensteuer steuerelement muss immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung 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 Tabellensteuerfeld ruft in der Regel den Wert für seinen Namen aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung 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, 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 Tabellensteuerfeld Elemente enthält, die in einem Raster angezeigt werden, unterstützt es immer das Grid-Steuerelementmuster.
IGridItemProvider Erforderlich mit 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 nur unterstützen, wenn die Tabelle Teil einer anderen Tabelle ist.
ITableProvider Erforderlich Dem Tabellensteuerelement können immer Header zugeordnet sein.
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 von Tabellensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis.
UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. 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