Gruppensteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Gruppensteuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Ein Gruppensteuerelement stellt einen Knoten innerhalb einer Hierarchie dar. Der Gruppensteuerelementtyp erstellt eine Trennung in der Benutzeroberflächenautomatisierung Struktur, sodass Elemente, die gruppiert werden, eine logische Aufteilung innerhalb der Benutzeroberflächenautomatisierung Struktur aufweisen.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Gruppensteuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Gruppensteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert ist.
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 Gruppensteuerelemente 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 |
---|---|
|
|
Gruppensteuerelemente umfassen in der Regel Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen, die sich unten in der Unterstruktur befinden, einschließlich der Steuerelementtypen ListItem, TreeItem und DataItem. Da es sich bei einem Gruppensteuerelement um einen generischen Container handelt, ist es möglich, dass sich ein beliebiger Steuerelementtyp unter dem Gruppensteuerelement in der Struktur befindet.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Gruppensteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
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 umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie einen klickbaren Punkt bereit. |
UIA_ControlTypePropertyId | Gruppieren | |
UIA_IsContentElementPropertyId | TRUE | Das Gruppensteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
UIA_IsControlElementPropertyId | TRUE | Das Gruppensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
UIA_LabeledByPropertyId | Siehe Hinweise. | Gruppensteuerelemente sind in der Regel selbstbezeichnend. Geben Sie in diesen Fällen NULL zurück. Wenn die Gruppe über eine statische Textbeschriftung verfügt, geben Sie die Bezeichnung als Wert der LabeledBy-Eigenschaft zurück. |
UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Gruppensteuerelementtyp entspricht. Der Standardwert ist "group" für en-US oder English (USA). |
UIA_NamePropertyId | Siehe Hinweise. | Das Gruppensteuerelement ruft seinen Namen in der Regel aus dem Text ab, mit dem das Steuerelement beschriftet ist. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die für den Gruppensteuerelementtyp unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
Steuerelementmuster | Support | Notizen |
---|---|---|
IExpandCollapseProvider | Depends (Abhängig) | Gruppensteuerelemente, die zum Ein- oder Ausblenden von Informationen verwendet werden können, müssen das ExpandCollapse-Steuerelementmuster unterstützen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Gruppensteuerelemente 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_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Steuerelementmuster des ExpandCollapse-Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen. |
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
UIA_ToggleToggleStatePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Steuerelementmuster "Umschalten" unterstützt, muss es dieses Ereignis unterstützen. |
UIA_StructureChangedEventId |
Zugehörige Themen