Benutzeroberflächenautomatisierungs-Unterstützung für den Group-Steuerelementtyp
.gif "Hinweis") Hinweis |
|---|
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation. |
Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Group-Steuerelementtyp. In UI Automation 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 Automation tree structure, UI Automation-Eigenschaftswerte und UI Automation Steuerelementmuster ein.
Das Group-Steuerelement stellt einen Knoten innerhalb einer Hierarchie dar. Der Group-Steuerelementtyp erstellt eine Trennung in der UI Automation-Struktur, sodass gruppierte Elemente eine logische Unterteilung innerhalb der UI Automation-Struktur aufweisen.
In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Group-Steuerelementtyp erforderlich sind. Die UI Automation-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 Automation-Struktur für Group-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
Gruppe
|
Gruppe
|
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 Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Group-Steuerelemente besonders wichtig sind. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI Automation-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
|
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
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. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Das Group-Steuerelement ruft seinen Namen in der Regel aus dem Text ab, mit dem das Steuerelement beschriftet ist. |
|
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. |
|
Gruppe |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Gruppe" |
Lokalisierte Zeichenfolge für den Group-Steuerelementtyp. |
|
True |
Das Group-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten. |
|
True |
Die Kalendergruppe ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle werden die UI Automation-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 |
Unterstützung |
Hinweise |
|---|---|---|
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 Automation-Ereignisse aufgeführt, die von allen Group-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI Automation-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 |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Referenz
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung