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