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 zur UI-Automatisierung-Unterstützung für den Struktur-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 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-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Struktur-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur für Struktur-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Die Steuerelementansicht der UI-Automatisierung-Struktur besteht aus:
Keinen oder mehreren Elementen innerhalb des Containers (Elemente können auf dem TreeItem- Steuerelementtyp oder dem DataItem-Steuerelementtyp basieren).
Keine, eine oder zwei Bildlaufleisten.
Die Inhaltsansicht der UI-Automatisierung-Struktur besteht aus keinen oder mehreren Elementen innerhalb des Containers (Elemente können auf dem TreeItem- Steuerelementtyp oder DataItem-Steuerelementtyp basieren).
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für die Listensteuerelemente besonders wichtig sind. 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, das gesamte Steuerelement umfassende Rechteck. |
|
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. |
|
Strukturansicht |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
True |
Das Tree-Steuerelement ist in der Inhaltsansicht der UI-Automatisierung-Struktur immer enthalten. |
|
True |
Das Tree-Steuerelement ist in der Steuerelementansicht der UI-Automatisierung-Struktur immer enthalten. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
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. |
|
"Struktur" |
Lokalisierte Zeichenfolge für den List-Steuerelementtyp. |
|
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-Automatisierung-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 |
|---|---|---|
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. |
|
Siehe Hinweise. |
Implementieren Sie diese Eigenschaft, wenn das Tree-Steuerelement eine Mehrfachauswahl unterstützt (meistens ist dies nicht der Fall). |
|
Siehe Hinweise. |
Der Wert dieser Eigenschaft ist verfügbar, wenn für das Steuerelement die Auswahl eines Elements erforderlich ist. |
|
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-Automatisierung-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-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
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 |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung