Benutzeroberflächenautomatisierungs-Unterstützung für den List-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen zur UI-Automatisierung-Unterstützung für den List-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 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-Automatisierung-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 Steuerelementmuster der Benutzeroberflächenautomatisierung
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die beiden Ansichten der UI-Automatisierung-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-Automatisierung-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. |
|
|
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-Automatisierung-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-Automatisierung-Struktur des Listensteuerelements verfügbar. Alle Elemente innerhalb des Listensteuerelements müssen zur gleichen Auswahlgruppe gehören.
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 die 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. |
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. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
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. |
|
Siehe Hinweise. |
Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
|
Liste |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Liste" |
Lokalisierte Zeichenfolge für den List-Steuerelementtyp. |
|
True |
Das Listensteuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Das Listensteuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftenwert True sein. |
|
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 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 |
|---|---|---|
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. |
|
Variabel |
In einem Listensteuerelement muss nicht immer ein Element ausgewählt sein. |
|
Variabel |
Listensteuerelemente können Container für Einfach- oder Mehrfachauswahl sein. |
|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn Elemente im Container bildlauffähig sind. |
|
Variabel |
Implementieren Sie dieses Muster, wenn die Rasternavigation auf Grundlage einzelner Elemente zur Verfügung stehen soll. |
|
Variabel |
Implementieren Sie dieses Steuerelementmuster, wenn das Steuerelement mehrere Ansichten für die Elemente im Container unterstützen soll. |
|
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-Automatisierung-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-Automatisierung-Ereignis |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Variabel |
Keine |
|
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 |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung