Listensteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp List.
Der steuerelementtyp List bietet eine Möglichkeit, eine flache Gruppe oder Gruppen von Elementen zu organisieren und einem Benutzer das Auswählen eines oder mehrerer dieser Elemente zu ermöglichen. Der Listen--Steuerelementtyp hat eine lose Einschränkung, welche Typen untergeordneter Elemente enthalten können. Auf diese Weise können Benutzeroberflächenautomatisierungs-Anbieter ein bekanntes Element für Auswahlcontainer unterstützen.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den steuerelementtyp List definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster und Eigenschaften
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Listensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Enthält die Elemente, die Steuerelementen entsprechen. | Entfernt redundante Informationen aus der Struktur, sodass Hilfstechnologien mit dem kleinsten Satz von Informationen arbeiten, die für den Endbenutzer aussagekräftig sind. |
|
|
Die Steuerelementansicht für ein Steuerelement, das den Listensteuerelementtyp implementiert (z. B. ein Listensteuerelement), besteht aus:
- Null oder mehr Elemente innerhalb des Listensteuerelements (Elemente können auf dem ListItem- oder DataItem-Steuerelementtypen basieren)
- Null oder mehr Gruppensteuerelemente innerhalb eines Listensteuerelements
- Null-, ein oder zwei Bildlaufleisten-Steuerelemente
Die Inhaltsansicht eines Steuerelements, das den Listensteuerelementtyp implementiert (z. B. ein Listensteuerelement), besteht aus:
- Null oder mehr Elemente innerhalb des Listensteuerelements (Elemente können auf dem ListItem- oder DataItem-Steuerelementtypen basieren)
- Null oder mehr Gruppen innerhalb des Listensteuerelements
Ein Listensteuerelement darf keine Elemente enthalten, die eine andere hierarchische Beziehung haben, als zusammen gruppiert zu werden. Wenn die Elemente untergeordnete Elemente in der Benutzeroberflächenautomatisierungs-Struktur haben, sollte der Listencontainer auf dem Struktur- Steuerelementtyp basieren.
Die auswählbaren Elemente innerhalb des Listensteuerelements stehen von den Nachfolgern in der Benutzeroberflächenautomatisierungs-Struktur des Listensteuerelements zur Verfügung. Alle Elemente innerhalb des Listensteuerelements müssen derselben Auswahlgruppe angehören. Die auswählbaren Elemente in der Liste sollten als ListItem- (anstelle von DataItem-)-Steuerelementtypen verfügbar gemacht werden.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den steuerelementtyp List relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Wenn das Listensteuerelement über einen klickbaren Punkt verfügt (ein Punkt, auf den geklickt werden kann, damit die Liste den Fokus erhält), muss dieser Punkt über diese Eigenschaft verfügbar gemacht werden. Wenn der Wert der UIA_IsOffscreenPropertyId-Eigenschaft TRUEist, führt der Versuch, diese Eigenschaft abzurufen, zum UIA_E_NOCLICKABLEPOINT Fehler. |
| UIA_ControlTypePropertyId | Listen- | |
| UIA_HelpTextPropertyId | Siehe Hinweise. | Der Hilfetext für Listensteuerelemente sollte erläutern, warum der Benutzer aufgefordert wird, eine Auswahl aus einer Liste von Optionen zu treffen. Beispiel: "Auswahl eines Elements aus dieser Liste legt die Anzeigeauflösung für Ihren Monitor fest." |
| UIA_IsContentElementPropertyId | TRUE- | Das Listensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE- | Das Listensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Wenn eine statische Textbeschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp List entspricht. Der Standardwert ist "list" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Der Wert der Name-Eigenschaft eines Listensteuerelements sollte die Kategorie der Optionen vermitteln, aus denen der Benutzer zur Auswahl aufgefordert wird. Diese Eigenschaft ruft ihren Namen in der Regel aus einer statischen Textbeschriftung ab. Wenn keine statische Textbeschriftung vorhanden ist, muss der Anwendungsentwickler einen Wert für die eigenschaft Name verfügbar machen. Die einzige Zeit, zu der diese Eigenschaft für Listensteuerelemente nicht erforderlich ist, besteht darin, dass das Steuerelement innerhalb der Unterstruktur eines anderen Steuerelements verwendet wird. |
Erforderliche Steuerelementmuster und -eigenschaften
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen 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 | Notizen |
|---|---|---|
| IGridProvider- | Hängt | Implementieren Sie das Grid- Steuerelementmuster, wenn die Rasternavigation auf Elementbasis verfügbar sein muss. |
| IMultipleViewProvider- | Hängt | Implementieren Sie das MultipleView Steuerelementmuster, wenn das Steuerelement mehrere Ansichten der Elemente im Container unterstützen kann. |
| IScrollProvider- | Hängt | Implementieren Sie das Scroll- Steuerelementmuster, wenn Elemente im Container bildlauffähig sind. |
| ISelectionProvider- | Hängt | Wenn ein Steuerelement den Listensteuerelementtyp unterstützt, der die Auswahl unterstützt, muss das Steuerelement das Selection Steuerelementmuster implementieren, wenn ein Auswahlstatus zwischen den im Steuerelement enthaltenen Elementen beibehalten wird. Wenn die Elemente innerhalb des Steuerelements nicht ausgewählt werden können, kann der Gruppen- Steuerelementtyp verwendet werden. |
| CanSelectMultiple- | Hängt | Listensteuerelemente können einzelne oder Mehrfachauswahlcontainer sein. |
| IsSelectionRequired- | Hängt | Listensteuerelemente erfordern nicht immer, dass ein Element ausgewählt wird. |
| ITableProvider- | Nie | Das Steuerelementmuster Tabelle wird für den steuerelementtyp List nie unterstützt. Wenn das Steuerelement dieses Steuerelementmusters unterstützen muss, sollte das Steuerelement auf dem DataGrid--Steuerelementtyp basieren. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Listensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_LayoutInvalidatedEventId | Wenn das Layout untergeordneter Elemente geändert werden kann, muss das Steuerelement dieses Ereignis unterstützen. |
| UIA_MultipleViewCurrentViewPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das MultipleView Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_Selection_InvalidatedEventId | Wenn das Steuerelement das Selection Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung