Kopfzeilen-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Header- Steuerelementtyp.
Das Kopfzeilensteuerelement stellt einen visuellen Container für die Beschriftungen für Zeilen oder Spalten von Informationen bereit.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Header- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Kopfzeilensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung 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 zu Kopfzeilensteuerelementen gehört, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
(Nicht zutreffend) |
Kopfzeilensteuerelemente verfügen immer über mindestens ein untergeordnetes Element in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur.
Kopfzeilensteuerelemente verfügen über null untergeordnete Elemente in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Kopfzeilensteuerelemente 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 für alle Steuerelemente in einer Anwendung 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 | Header- | |
| UIA_IsContentElementPropertyId | FALSCH | Das Kopfzeilensteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsControlElementPropertyId | STIMMT | Das Kopfzeilensteuerelement 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 | Kopfzeilensteuerelemente verfügen nicht über eine statische Beschriftung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Der Standardwert ist "header" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Kopfzeilensteuerelement benötigt einen Namen, wenn mehrere Zeilenüberschriften oder mehrere Spaltenüberschriften vorhanden sind. Dadurch werden die Informationen in der Kopfzeile identifiziert. |
| UIA_OrientationPropertyId | OrientationType_Horizontal oder OrientationType_Vertical | Der Wert dieser Eigenschaft macht die Position des Kopfzeilensteuerelements verfügbar – unabhängig davon, ob es sich um eine Zeilenüberschrift (OrientationType_Horizontal) oder Spaltenüberschrift (OrientationType_Vertical) handelt. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die für Kopfzeilensteuerelemente unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| ITransformProvider- | Hängt | Implementieren Sie das Transformieren Steuerelementmusters, wenn die Größe des Kopfzeilensteuerelements geändert werden kann. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die Kopfzeilensteuerelemente 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