Freigeben über

Gruppensteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der 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ächenautomatisierungsstruktur, sodass Elemente, die gruppiert sind, innerhalb der Benutzeroberflächenautomatisierungs-Struktur eine logische Division aufweisen.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den steuerelementtyp Gruppe definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Gruppensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Gruppensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Gruppe
    • 0 oder viele Steuerelemente
  • Gruppe
    • 0 oder viele Steuerelemente

 

Gruppensteuerelemente enthalten in der Regel unterstützung für die Benutzeroberflächenautomatisierung für Steuerelementtypen, die darunter in der Unterstruktur zu finden sind, einschließlich der ListItem-, TreeItem-und DataItem- Steuerelementtypen. Da es sich bei einem Gruppensteuerelement um einen generischen Container handelt, ist es möglich, dass sich jeder Steuerelementtyp unter dem Gruppensteuerelement in der Struktur befindet.

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Gruppensteuerelemente 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 zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur 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 Gruppen-
UIA_IsContentElementPropertyId TRUE- Das Gruppensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE- Das Gruppensteuerelement 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 Siehe Hinweise. Gruppensteuerelemente sind in der Regel selbstbeschriftung. Geben Sie in diesen Fällen NULL-zurück. Wenn die Gruppe über eine statische Textbeschriftung verfügt, geben Sie die Beschriftung als Wert der eigenschaft LabeledBy zurück.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Gruppe entspricht. Der Standardwert ist "group" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Das Gruppensteuerelement ruft in der Regel seinen Namen aus dem Text ab, der das Steuerelement beschriftt.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die für den steuerelementtyp Gruppe unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützen Notizen
IExpandCollapseProvider Hängt 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ächenautomatisierungsereignisse aufgeführt, die Gruppensteuerelemente 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_ExpandCollapseExpandCollapseStatePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das ExpandCollapse Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
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_ToggleToggleStatePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Umschalten Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung