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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
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 |
|---|---|
|
|
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 |