Benutzeroberflächenautomatisierungs-Unterstützung für den TreeItem-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 über die UI Automation-Unterstützung für den TreeItem-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 TreeItem-Steuerelementtyp stellt einen Knoten innerhalb eines Strukturcontainers dar. 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 TreeItem-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle TreeItem-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, die sich auf TreeItem-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
TreeItem Kontrollkästchen (0 oder 1) Bild (0 oder 1) Button (0 oder 1) TreeItem (beliebige Anzahl)	TreeItem TreeItem (beliebige Anzahl)

TreeItem-Steuerelemente können in der Inhaltsansicht der UI Automation-Struktur keine oder mehrere untergeordnete Elemente aufweisen. Wenn das TreeItem-Steuerelement mehr Funktionen aufweist als diejenigen, die von den unten aufgelisteten Steuerelementmustern verfügbar gemacht werden, muss das Steuerelement auf dem DataItem-Steuerelementtyp basieren.

Reduzierte Strukturelemente werden erst dann in der Steuerelementansicht oder in der Inhaltsansicht angezeigt, wenn sie erweitert und sichtbar werden (oder durch einen Bildlauf angezeigt werden können).

Die Steuerelementansicht kann weitere Details für ein Steuerelement enthalten, wie etwa für ein zugeordnetes Bild oder eine Schaltfläche. Ein Element in einer Gliederungsansicht kann beispielsweise ein Bild sowie eine Schaltfläche zu Erweitern oder Reduzieren der Gliederung enthalten. Diese Detailobjekte werden nicht in der Inhaltsansicht angezeigt, da die Informationen bereits vom übergeordneten Strukturelement dargestellt werden. Strukturelemente, die sich außerhalb des Bildschirms befinden, werden sowohl in der Steuerelement- als auch in der Inhaltsansicht der UI Automation-Struktur angezeigt. Ihre IsOffscreenProperty muss auf "true" festgelegt sein.

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 zu UI Automationseigenschaften 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 Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	Siehe Hinweise.	Diese Eigenschaft muss eine Position des Elements zurückgeben, wodurch der Auswahlzustand des Elements geändert wird bzw. wodurch es den Fokus erhält.
ControlTypeProperty	TreeItem	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
IsContentElementProperty	True	Das Listensteuerelement ist immer in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das Listen-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.
IsOffscreenProperty	Siehe Hinweise.	Diese Eigenschaft wird festgelegt, um anzugeben, wann ein TreeItem-Steuerelement sich außerhalb des Bildschirms befindet.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
ItemTypeProperty	Siehe Hinweise.	Wenn das TreeItem-Steuerelement durch ein visuelles Symbol anzeigt, dass es sich um einen bestimmten Objekttyp handelt, muss diese Eigenschaft unterstützt werden und angeben, worum es sich bei dem Objekt handelt.
LabeledByProperty	Null	TreeItem-Steuerelemente sind selbstbezeichnend.
LocalizedControlTypeProperty	"Strukturelement"	Lokalisierte Zeichenfolge, die dem TreeItem-Steuerelementtyp entspricht.
NameProperty	Siehe Hinweise.	Diese Eigenschaft macht den für jedes TreeItem-Steuerelement angezeigten Text verfügbar.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Listen-Steuerelementen 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
IInvokeProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn das Strukturelement über einen einzelnen, ausführbaren Befehl verfügt.
IExpandCollapseProvider	Ja	Alle Strukturelemente können erweitert oder reduziert werden.
ExpandCollapseState	Erweitert, reduziert oder Blattknoten	Strukturelemente sind Blattknoten, wenn sie nicht erweitert oder reduziert werden.
IScrollItemProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn der Strukturcontainer das Scroll-Steuerelementmuster unterstützt.
ISelectionItemProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn eine aktive Auswahl möglich ist, die erhalten bleibt, wenn der Benutzer zum Strukturcontainer zurückkehrt.
SelectionContainer	Ja	Diese Eigenschaft macht den gleichen Container für alle Elemente innerhalb des Containers verfügbar.
IToggleProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn dem Strukturelement ein Kontrollkästchen zugeordnet ist.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
AutomationFocusChangedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte ItemStatusProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
InvokedEvent	Variabel	Keine
Durch geänderte CurrentViewProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
ElementAddedToSelectionEvent	Variabel	Keine
ElementRemovedFromSelectionEvent	Variabel	Keine
ElementSelectedEvent	Variabel	Keine
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine

Siehe auch

Referenz

TreeItem

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung