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.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Tree“. Bei der Benutzeroberflächenautomatisierung ist ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur des UI-Automatisierungsbaums, die Eigenschaftenwerte der UI-Automatisierung und die Steuerungsmuster.
Der Baumstruktur-Steuerelementtyp wird für Container verwendet, deren Inhalte als Knotenhierarchie relevant sind, wie Dateien und Ordner im linken Bereich von Microsoft Windows Explorer angezeigt werden. Jeder Knoten kann andere Knoten enthalten, die als untergeordnete Knoten bezeichnet werden. Übergeordnete Knoten oder Knoten, die untergeordnete Knoten enthalten, können als erweitert oder reduziert angezeigt werden.
In den folgenden Abschnitten werden die erforderliche Baumstruktur der UI-Automatisierung, die Eigenschaften, Steuerelementmuster und Ereignisse für den Baum-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Struktursteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
Die folgende Tabelle zeigt die Bedienansicht und die Inhaltsansicht des UI-Automatisierungsbaums, der sich auf Baumsteuerungen bezieht. Sie beschreibt, was in den jeweiligen Ansichten enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungs-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
Baum
|
Baum
|
Die Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur besteht aus:
Keinem oder mehreren Elementen innerhalb des Containers (Elemente können auf dem TreeItem-, DataItem- oder einem anderen Steuerelementtyp basieren)
Keiner, einer oder zwei Bildlaufleisten
Die Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur besteht aus keinem 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 sind die Benutzeroberflächenautomatisierungs-Eigenschaften aufgeführt, deren Wert oder Definition besonders für Listensteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Struktursteuerelemente 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 wird bzw. den Fokus erhält. |
| ControlTypeProperty | Baum | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| IsContentElementProperty | Richtig | Das Struktursteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| IsControlElementProperty | Richtig | Das Struktursteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| LabeledByProperty | Siehe Hinweise. | Wenn dem Sturktursteuerelement eine Bezeichnung zugeordnet wurde, wird von dieser Eigenschaft ein AutomationElement für diese Bezeichnung zurückgegeben. Andernfalls gibt die Eigenschaft einen Nullverweis (Nothing in Microsoft Visual Basic .NET) zurück. |
| LocalizedControlTypeProperty | „Struktur“ | Lokalisierte Zeichenfolge, die dem Listensteuerelementtyp entspricht. |
| NameProperty | Siehe Hinweise. | Der Wert der Namenseigenschaft eines Struktursteuerelements stammt in der Regel aus Text, der das Steuerelement beschriftt. Wenn keine Textbeschriftung vorhanden ist, muss der Anwendungsentwickler einen Wert für diese Eigenschaft angeben. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Listensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Control Pattern/Pattern-Eigenschaft | Support/Wert | Hinweise |
|---|---|---|
| ISelectionProvider | Hängt | Von Tree-Steuerelementen, die einen Satz auswählbarer Elemente enthalten, muss dieses Steuerelementmuster implementiert werden. Dieses Steuerelementmuster muss nicht implementiert werden, wenn das Auswählen eines Elements dem Benutzer keine aussagekräftigen Informationen vermittelt. |
| CanSelectMultiple | Siehe Hinweise. | Implementieren Sie diese Eigenschaft, wenn das Struktursteuerelement mehrere Auswahl unterstützt (die meisten Struktursteuerelemente unterstützen keine Mehrfachauswahl). |
| IsSelectionRequired | Siehe Hinweise. | Der Wert dieser Eigenschaft wird verfügbar gemacht, wenn das Steuerelement erfordert, dass ein Element ausgewählt wird. |
| IScrollProvider | Hängt | 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 sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Struktursteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Unterstützung | Hinweise |
|---|---|---|
| InvalidatedEvent | Hängt | Nichts |
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die HorizontallyScrollableProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| Durch die HorizontalScrollPercentProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| Durch die HorizontalViewSizeProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| Durch die VerticalScrollPercentProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| Durch die VerticallyScrollableProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| Durch die VerticalViewSizeProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |