Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den TreeItem-Steuerelementtyp. In UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte 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-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den TreeItem-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf TreeItem-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
TreeItem-Steuerelemente können in der Inhaltsansicht der UI-Automatisierung-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).
Strukturelemente, die sich außerhalb des Bildschirms befinden, werden sowohl in der Steuerelement- als auch in der Inhaltsansicht der UI-Automatisierung-Struktur angezeigt. Ihre IsOffscreenProperty muss auf "true" festgelegt sein.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für Listen-Steuerelemente besonders relevant ist. Weitere Informationen über 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. |
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
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. |
|
TreeItem |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
True |
Das Listen-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Das Listen-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten. |
|
Siehe Hinweise. |
Diese Eigenschaft wird festgelegt, um anzugeben, wann ein TreeItem-Steuerelement sich außerhalb des Bildschirms befindet. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
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. |
|
Null |
TreeItem-Steuerelemente sind selbstbezeichnend. |
|
"Strukturelement" |
Lokalisierte Zeichenfolge, die dem TreeItem-Steuerelementtyp entspricht. |
|
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-Automatisierung-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 |
|---|---|---|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn das Strukturelement über einen einzelnen, ausführbaren Befehl verfügt. |
|
Ja |
Alle Strukturelemente können erweitert oder reduziert werden. |
|
Erweitert, reduziert oder Blattknoten |
Strukturelemente sind Blattknoten, wenn sie nicht erweitert oder reduziert werden. |
|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn der Strukturcontainer das Scroll-Steuerelementmuster unterstützt. |
|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn eine aktive Auswahl möglich ist, die erhalten bleibt, wenn der Benutzer zum Strukturcontainer zurückkehrt. |
|
Ja |
Diese Eigenschaft macht den gleichen Container für alle Elemente innerhalb des Containers verfügbar. |
|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn dem Strukturelement ein Kontrollkästchen zugeordnet ist. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle werden die UI-Automatisierung-Ereignisse aufgelistet, die von allen TreeItem-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes ItemStatusProperty-Ereignis. |
Variabel |
Keine |
Durch geänderte Eigenschaft ausgelöstes NameProperty-Ereignis. |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes ExpandCollapseStateProperty-Ereignis. |
Erforderlich |
Keine |
Variabel |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes CurrentViewProperty-Ereignis. |
Variabel |
Keine |
Variabel |
Keine |
|
Variabel |
Keine |
|
Variabel |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes ToggleStateProperty-Ereignis. |
Variabel |
Keine |
Durch geänderte Eigenschaft ausgelöstes ValueProperty-Ereignis. |
Variabel |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung