Headersteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Header-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Ein Headersteuerelement stellt einen visuellen Container für Beschriftungen von Zeilen oder Spalten bereit, die Informationen enthalten.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Header-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Headersteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Headersteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
(Nicht vorhanden) |
Headersteuerelemente verfügen immer über ein oder mehrere untergeordnete Elemente in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur.
Header-Steuerelemente haben keine (Null) untergeordneten Elemente in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur.
Relevante Eigenschaften
Die folgende Tabelle listet die Benutzeroberflächenautomatisierungs-Eigenschaften auf, deren Werte oder Definitionen für Header-Steuerelemente besonders relevant sind. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung 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 umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | Kopfzeile | |
| UIA_IsContentElementPropertyId | FALSE | Das Header-Steuerelement ist in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur nicht enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Das Header-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | NULL | Headersteuerelemente haben keine statische Bezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Der Standardwert ist "header" für en-US oder English (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Headersteuerelement benötigt einen Namen, wenn mehrere Zeilen- oder Spaltenüberschriften vorhanden sind. Dadurch werden die Informationen für den Header (Überschrift) gekennzeichnet. |
| UIA_OrientationPropertyId | OrientationType_Horizontal oder OrientationType_Vertical | Der Wert dieser Eigenschaft macht die Position des Headersteuerelements verfügbar – unabhängig davon, ob es sich um einen Zeilenheader (OrientationType_Horizontal) oder einen Spaltenheader (OrientationType_Vertical) handelt. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die für Headersteuerelemente unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| ITransformProvider | Depends (Abhängig) | Implementieren Sie das Transformationssteuerelementmuster, wenn die Größe des Headersteuerelements geändert werden kann. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Headersteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| 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