Benutzeroberflächenautomatisierungs-Unterstützung für den Group-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Group-Steuerelementtyp. In UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft zu verwenden. Die Bedingungen schließen bestimmte Richtlinien für UI-Automatisierung tree structure, UI-Automatisierung-Eigenschaftenwerte und UI-Automatisierung Steuerelementmuster ein.

Das Group-Steuerelement stellt einen Knoten innerhalb einer Hierarchie dar. Der Group-Steuerelementtyp erstellt eine Trennung in der UI-Automatisierung-Struktur, sodass gruppierte Elemente eine logische Unterteilung innerhalb der UI-Automatisierung-Struktur aufweisen.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Group-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Group-Steuerelemente, einschließlich Windows Presentation Foundation (WPF), Win32 und Windows Forms.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur für Group-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • Group

    • Beliebig viele Steuerelemente

  • Group

    • Beliebig viele Steuerelemente

Group-Steuerelemente weisen in der Regel den Steuerelementtyp Benutzeroberflächenautomatisierungs-Unterstützung für den ListItem-Steuerelementtyp, Benutzeroberflächenautomatisierungs-Unterstützung für den TreeItem-Steuerelementtyp oder Benutzeroberflächenautomatisierungs-Unterstützung für den DataItem-Steuerelementtyp auf, der sich in der Teilstruktur unterhalb der Steuerelemente befindet. Da es sich bei 'Group' um einen generischen Container handelt, kann sich in der Struktur unter dem Group-Steuerelement jeder Typ von Steuerelement befinden.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für Group-Steuerelemente besonders wichtig sind. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-Eigenschaft

Wert

Hinweise

AutomationIdProperty()

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

Siehe Hinweise.

Das Group-Steuerelement ruft seinen Namen in der Regel aus dem Text ab, mit dem das Steuerelement beschriftet ist.

LabeledByProperty

Siehe Hinweise.

Group-Steuerelemente sind in der Regel selbstbezeichnend. Wenn dies der Fall ist, wird hier null zurückgegeben. Wenn für die Gruppe eine statische Textbezeichnung vorhanden ist, muss diese Bezeichnung als Wert der LabeledBy-Eigenschaft zurückgegeben werden.

ControlTypeProperty

Group

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Gruppe"

Lokalisierte Zeichenfolge für den Group-Steuerelementtyp.

IsContentElementProperty

True

Das Group-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten.

IsControlElementProperty

True

Die Kalendergruppe ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-Steuerelementmuster aufgelistet, die für den Group-Steuerelementtyp unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

IExpandCollapseProvider

Variabel

Group-Steuerelemente, mit denen Informationen ein- oder ausgeblendet werden können, müssen das ExpandCollapse-Muster unterstützen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgeführt, die von allen Group-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

Group