Tabellensteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Tabellen- Steuerelementtyp.
Tabellensteuerelemente enthalten Zeilen und Spalten mit Text und optional Zeilenüberschriften und Spaltenüberschriften.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Table-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Tabellensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Tabellensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Wenn ein Tabellensteuerelement Zeilen- oder Spaltenüberschriften enthält, müssen sie in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur verfügbar gemacht werden. Die Inhaltsansicht muss diese Informationen nicht verfügbar machen, da über IUIAutomationTablePatterndarauf zugegriffen werden kann.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Tabellensteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | Tabelle | |
| UIA_DescribedByPropertyId | Siehe Hinweise. | Wenn die Tabelle von einem anderen UI-Element kommentiert wird (z. B. ein Textelement, das die Beschreibung für die Tabelle enthält), 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 sie von der UIA_NamePropertyId-Eigenschaft nicht ausreichend erläutert wird. |
| UIA_IsContentElementPropertyId | STIMMT | Das Tabellensteuerelement muss immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur angezeigt werden. |
| UIA_IsControlElementPropertyId | STIMMT | Das Tabellensteuerelement muss immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 Textbeschriftung vorhanden ist, sollte diese Eigenschaft einen Verweis auf das Automatisierungselement des Steuerelements verfügbar machen. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp Table entspricht. Der Standardwert ist "tabelle" 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 Beschriftung 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 Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Tabellensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| IGridProvider- | Erforderlich | Da das Tabellensteuerelement Elemente enthält, die in einem Raster angezeigt werden, unterstützt es immer das Raster- Steuerelementmuster. |
| IGridItemProvider- | Erforderlich bei untergeordneten Objekten | Die inneren Objekte einer Tabelle sollten sowohl die GridItem- als auch TableItem- Steuerelementmuster unterstützen. Die Tabelle selbst benötigt keine Unterstützung für das GridItem- oder TableItem-Steuerelementmuster, es sei denn, die Tabelle ist Teil einer anderen Tabelle. |
| ITableProvider- | Erforderlich | Das Tabellensteuerelement kann dem Inhalt immer Überschriften zugeordnet sein. |
| ITableItemProvider- | Erforderlich bei untergeordneten Objekten | Die inneren Objekte einer Tabelle sollten sowohl die GridItem- als auch TableItem- Steuerelementmuster unterstützen. Die Tabelle selbst muss die GridItem- oder TableItem-Steuerelementmuster nur unterstützen, wenn die Tabelle Teil einer anderen Tabelle ist. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Tabellensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung