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

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 zur UI Automation-Unterstützung für den Struktur-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Der Tree-Steuerelementtyp wird für Container verwendet, deren Inhalt eine Knotenhierarchie aufweist, wie z. B. die im linken Bereich von Microsoft Windows Explorer angezeigten Dateien und Ordner. Jeder Knoten kann andere Knoten enthalten, die als untergeordnete Knoten bezeichnet werden. Übergeordnete Knoten oder Knoten mit untergeordneten Knoten können in erweiterter oder reduzierter Form angezeigt werden.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Struktur-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Struktur-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

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 Struktur-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
Strukturansicht DataItem (beliebige Anzahl) TreeItem (beliebige Anzahl) TreeItem (beliebige Anzahl)• … ScrollBar (0, 1, 2)	Strukturansicht DataItem (beliebige Anzahl) TreeItem (beliebige Anzahl) TreeItem (beliebige Anzahl)• …

Die Steuerelementansicht der UI Automation-Struktur besteht aus:

• keinen oder mehreren Elementen innerhalb des Containers (Elemente können auf dem TreeItem-, DataItem- oder einem anderen Steuerelementtyp basieren).

• Keine, eine oder zwei Bildlaufleisten.

Die Inhaltsansicht der UI Automation-Struktur besteht aus keinen oder mehreren Elementen innerhalb des Containers (Elemente können auf dem TreeItem-, DataItem- oder einem anderen Steuerelementtyp basieren).

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für Listen-Steuerelemente besonders relevant ist. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-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, das gesamte Steuerelement umfassende Rechteck.
ClickablePointProperty	Siehe Hinweise.	Tree-Steuerelemente enthalten einen durch Klicken aktivierbaren Punkt, mit dem der Fokus auf die Struktur oder auf eines der Elemente im Strukturcontainer gelegt werden kann. Für einen durch Klicken aktivierbaren Punkt muss in der Struktur ein Bereich vorhanden sein, auf den geklickt werden kann, ohne dass eines der Elemente ausgewählt bzw. hervorgehoben wird.
ControlTypeProperty	Strukturansicht	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
IsContentElementProperty	True	Das Tree-Steuerelement ist in der Inhaltsansicht der UI Automation-Struktur immer enthalten.
IsControlElementProperty	True	Das Tree-Steuerelement ist in der Steuerelementansicht der UI Automation-Struktur immer enthalten.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
LabeledByProperty	Siehe Hinweise.	Wenn dem Tree-Steuerelement eine Bezeichnung zugeordnet wurde, wird von dieser Eigenschaft ein AutomationElement für diese Bezeichnung zurückgegeben. Andernfalls wird von der Eigenschaft ein NULL-Verweis (Nothing in Microsoft Visual Basic .NET) zurückgegeben.
LocalizedControlTypeProperty	"Struktur"	Lokalisierte Zeichenfolge für den List-Steuerelementtyp.
NameProperty	Siehe Hinweise.	Der Wert der Namenseigenschaft eines Tree-Steuerelements entspricht normalerweise dem Text, durch den das Steuerelement bezeichnet wird. Wenn kein Bezeichnungstext vorhanden ist, muss der Anwendungsentwickler einen Wert für diese Eigenschaft angeben.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Listensteuerelementen 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
ISelectionProvider	Variabel	Von Tree-Steuerelementen, die einen Satz auswählbarer Elemente enthalten, muss dieses Steuerelementmuster implementiert werden. Dieses Steuerelementmuster muss nicht implementiert werden, wenn dem Benutzer beim Auswählen eines Elements keine sinnvollen Informationen vermittelt werden.
CanSelectMultiple	Siehe Hinweise.	Implementieren Sie diese Eigenschaft, wenn das Tree-Steuerelement eine Mehrfachauswahl unterstützt (meistens ist dies nicht der Fall).
IsSelectionRequired	Siehe Hinweise.	Der Wert dieser Eigenschaft ist verfügbar, wenn für das Steuerelement die Auswahl eines Elements erforderlich ist.
IScrollProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn für den Inhalt des Strukturcontainers ein Bildlauf ausgeführt werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Tree-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
InvalidatedEvent	Variabel	Keine
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 HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

Tree

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung