Gruppensteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Steuerelementtyp "Gruppe".
Ein Gruppensteuerelement stellt einen Knoten innerhalb einer Hierarchie dar. Der Steuerelementtyp Gruppe erstellt eine Trennung in der Benutzeroberflächenautomatisierung Struktur, sodass elemente, die zusammen gruppiert sind, eine logische Division 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 Benutzeroberflächenframework bzw. 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 Gruppensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Gruppensteuerelemente enthalten in der Regel Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen, die sich darunter in der Unterstruktur befinden, einschließlich der Steuerelementtypen ListItem, TreeItemund DataItem. Da ein Gruppensteuerelement ein generischer Container ist, ist es möglich, dass sich jeder 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 für die Gruppensteuerelemente 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 rohen Ansicht 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 umschließenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreibt und stellt einen klickbaren Punkt bereit. |
| UIA _ ControlTypePropertyId | Gruppe | |
| UIA _ IsContentElementPropertyId | TRUE | Das Gruppensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur 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 Textbezeichnung 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 Englisch (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 Steuerelementtyp Gruppe 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.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ ExpandCollapseExpandCollapseStatePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Steuerelementmuster ExpandCollapse unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ Das ToggleToggleStatePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Umschalten-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId |