Benutzeroberflächenautomatisierungs-Unterstützung für den List-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 List-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 List-Steuerelementtyp bietet eine Möglichkeit zum Organisieren von unstrukturierten Elementgruppen und ermöglicht dem Benutzer, eines oder mehrere der Elemente auszuwählen. Der List-Steuerelementtyp ist hinsichtlich der Typen, die er als untergeordnete Elemente enthalten kann, nur wenig eingeschränkt. Dadurch können Benutzeroberflächenautomatisierungsanbieter bekannte Elemente für Auswahlcontainer unterstützen.

Die UI Automation-Anforderungen in den folgenden Abschnitten gelten für alle Steuerelemente, die den List-Steuerelementtyp implementieren. Dies können Windows Presentation Foundation (WPF)-, Win32- und Windows Forms-Steuerelemente sein. Ein Beispiel für Steuerelemente, die den List-Steuerelementtyp implementieren, sind Listencontainer-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die beiden Ansichten der UI Automation-Struktur für Listensteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. In der Steueransicht sind nur Steuerelemente enthalten. In der Inhaltsansicht werden redundante Informationen aus der Struktur entfernt. Ein Textsteuerelement zum Beschriften eines Kombinationsfeld wird beispielsweise als ComboBox NameProperty verfügbar gemacht. Da das Textsteuerelement so bereits in der Steuerelementansicht verfügbar gemacht wird, ist es nicht erforderlich, das Element noch einmal verfügbar zu machen. Es wird daher aus der Inhaltsansicht entfernt. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Enthält die Elemente, die Steuerelementen entsprechen.	Entfernt redundante Informationen aus der Struktur, sodass Hilfstechnologien den kleinsten Satz von für den Endbenutzer sinnvollen Informationen verwenden.
Liste DataItem (beliebige Anzahl) ListItem (beliebige Anzahl) Group (beliebige Anzahl) ScrollBar (0, 1 oder 2)	List DataItem (beliebige Anzahl) ListItem (beliebige Anzahl) Group (beliebige Anzahl)

Die Steuerelementansicht für ein Steuerelement, das den List-Steuerelementtyp (z. B. ein Listensteuerelement) implementiert, umfasst die folgenden Elemente:

• Beliebige Anzahl von Elementen innerhalb des Listensteuerelements (Elemente können auf dem ListItem- Steuerelementtyp oder dem DataItem-Steuerelementtyp basieren)

• Beliebige Anzahl von Gruppensteuerelementen innerhalb eines Listensteuerelements

• Kein, ein oder zwei ScrollBar-Steuerelemente

Die Inhaltsansicht eines Steuerelements, das den List-Steuerelementtyp (z. B. ein Listensteuerelement) implementiert, besteht aus folgenden Elementen:

• Beliebige Anzahl von Elementen innerhalb des Listensteuerelements (Elemente können auf dem ListItem- Steuerelementtyp oder dem DataItem-Steuerelementtyp basieren)

• Beliebige Anzahl von Gruppen innerhalb des Listensteuerelements

Ein Listensteuerelement darf keine Elemente enthalten, die andere hierarchische Beziehungen als die Gruppierung aufweisen. Wenn die Elemente in der UI Automation-Struktur über untergeordnete Elemente verfügen, sollte der Listencontainer auf dem Tree-Steuerelementtyp basieren.

Die innerhalb des Listensteuerelements auswählbaren Elemente sind über die Nachfolgerelemente in der UI Automation-Struktur des Listensteuerelements verfügbar. Alle Elemente innerhalb des Listensteuerelements müssen zur gleichen Auswahlgruppe gehören. Die auswählbaren Elemente in der Liste sollten als ListItem-Steuerelementtypen (und nicht DataItem) verfügbar gemacht werden.

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.	Wenn das Listen-Steuerelement über einen klickbaren Punkt verfügt (ein Punkt, auf den geklickt werden kann, damit die Liste den Fokus erhält), muss dieser Punkt durch diese Eigenschaft verfügbar gemacht werden. Wenn der Wert der IsOffScreen-Eigenschaft True ist, wird NoClickablePointException ausgelöst.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Der Wert der Name-Eigenschaft eines Listensteuerelements sollte die Kategorie der Optionen vermitteln, die dem Benutzer zur Auswahl zur Verfügung stehen. Diese Eigenschaft ruft ihren Namen in der Regel aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, muss der Anwendungsentwickler einen Wert für die -Eigenschaften verfügbar machen. Nur wenn das Steuerelement innerhalb der Teilstruktur eines anderen Steuerelements verwendet wird, ist diese Eigenschaft für Listensteuerelemente nicht erforderlich.
LabeledByProperty	Siehe Hinweise.	Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.
ControlTypeProperty	Liste	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"Liste"	Lokalisierte Zeichenfolge für den List-Steuerelementtyp.
IsContentElementProperty	True	Das Listensteuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das Listen-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.
IsKeyboardFocusableProperty	True	Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftswert True sein.
HelpTextProperty	Siehe Hinweise.	Der Hilfetext für Listensteuerelemente sollte erläutern, warum der Benutzer aufgefordert wird, aus einer Liste von Optionen auszuwählen. Beispiel: "Durch Auswählen eines Elements in dieser Liste wird die Anzeigeauflösung für den Bildschirm festgelegt."

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften

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
ISelectionProvider	Erforderlich	Alle Steuerelemente, die den List-Steuerelementtyp unterstützen, müssen ISelectionProvider implementieren, wenn der Auswahlzustand der im Steuerelement enthaltenen Elemente beibehalten wird. Wenn die Elemente innerhalb des Containers nicht auswählbar sind, muss der Group-Steuerelementtyp verwendet werden.
IsSelectionRequired	Variabel	In einem Listensteuerelement muss nicht immer ein Element ausgewählt sein.
CanSelectMultiple	Variabel	Listensteuerelemente können Container für Einfach- oder Mehrfachauswahl sein.
IScrollProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn Elemente im Container bildlauffähig sind.
IGridProvider	Variabel	Implementieren Sie dieses Muster, wenn die Rasternavigation auf Grundlage einzelner Elemente zur Verfügung stehen soll.
IMultipleViewProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn das Steuerelement mehrere Ansichten für die Elemente im Container unterstützen soll.
ITableProvider	Nie	Für den List-Steuerelementtyp wird ITableProvider nicht unterstützt. Wenn das Steuerelement dieses Steuerelementmuster unterstützen soll, sollte das Steuerelement auf dem DataGrid-Steuerelementtyp basieren.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung/Wert	Hinweise
InvalidatedEvent	Variabel	Keine
LayoutInvalidatedEvent	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 CurrentViewProperty-Eigenschaft ausgelöstes Ereignis	Variabel	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

List

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung