Freigeben über


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

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
  • Group
    • Beliebig viele Steuerelemente
  • Group
    • Beliebig viele Steuerelemente

 

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

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung