ListItem-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den ListItem-Steuerelementtyp.
Listenelementsteuerelemente sind ein Beispiel für Steuerelemente, die den ListItem-Steuerelementtyp implementieren.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ListItem-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Listenelementsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Listenelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Die untergeordneten Elemente eines Listenelementsteuerelements in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur müssen immer 0 untergeordnete Elemente anzeigen. Wenn die Struktur des Steuerelements so ist, dass unter dem Listenelement andere Elemente enthalten sind, sollte es die Anforderungen für die Benutzeroberflächenautomatisierung Unterstützung für den TreeItem-Steuerelementtyp erfüllen.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den ListItem-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. Ordnen Sie die AutomationId-Eigenschaft für ein Listenelement zu, wenn bekannt ist, dass das Element über verschiedene Instanzen der Benutzeroberfläche hinweg konsistent ist. Wenn das Listenelement dynamisch aufgefüllt und nicht vorhersagbar ist, lassen Sie die AutomationId-Eigenschaft leer. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft sollte den Bereich des Bilds und den Textinhalt des Listenelements enthalten. |
| UIA _ ClickablePointPropertyId | Depends (Abhängig) | 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 das Listensteuerelement vollständig von Nachfolgerlistenelementen abgedeckt wird, wird der UIA _ E _ NOCLICKABLEPOINT-Fehler zurückgegeben, um anzugeben, dass der Client ein Element innerhalb des Listensteuerelements nach einem klickbaren Punkt fragen muss. |
| UIA _ ControlTypePropertyId | ListItem | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| UIA _ HelpTextPropertyId | Siehe Hinweise. | Im Hilfetext für Listensteuerelemente sollte erklärt werden, warum der Benutzer aufgefordert wird, eine Auswahl aus einer Liste von Optionen zu treffen. Hierbei handelt es sich in der Regel um dieselben Informationen, die durch ein QuickInfo angezeigt werden. Beispiel: "Wählen Sie ein Element aus, um die Anzeigeauflösung für Ihren Monitor festzulegen". |
| UIA _ IsContentElementPropertyId | TRUE | Das Listensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Listensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftswert TRUE sein. |
| UIA _ IsOffscreenPropertyId | Depends (Abhängig) | Diese Eigenschaft muss einen Wert zurückgeben, der angibt, ob das Listenelement derzeit innerhalb des übergeordneten Containers, der das Scroll-Steuerelementmuster implementiert, in die Ansicht gescrollt wird. |
| UIA _ ItemStatusPropertyId | Depends (Abhängig) | Wenn das Steuerelement den Status enthält, der dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Updates erhalten kann, wenn sich der Status des Elements ändert. |
| UIA _ ItemTypePropertyId | Depends (Abhängig) | Diese Eigenschaft sollte für Listenelement-Steuerelemente verfügbar gemacht werden, die ein zugrunde liegendes Objekt darstellen. Bei diesen Listenelement-Steuerelementen ist dem Steuerelement normalerweise ein Symbol zugeordnet, das Benutzer mit dem zugrunde liegenden Objekt assoziieren. |
| UIA _ LabeledByPropertyId | Siehe Hinweise. | Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem ListItem-Steuerelementtyp entspricht. Der Standardwert ist "list item" für en-US oder Englisch (USA). |
| _UIA-NamePropertyId | Siehe Hinweise. | Der Wert der Namenseigenschaft eines Listenelementsteuerelements stammt aus der Textbezeichnung des Elements. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Listenelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Notizen |
|---|---|---|
| IExpandCollapseProvider | Depends (Abhängig) | Wenn das Element bearbeitet werden kann, um Informationen ein- oder auszublenden, muss das ExpandCollapse-Steuerelementmuster implementiert werden. |
| IGridItemProvider | Depends (Abhängig) | Wenn die räumliche Navigation von Element zu Element innerhalb des Listencontainers unterstützt wird und der Container in Zeilen und Spalten angeordnet ist, muss das GridItem-Steuerelementmuster implementiert werden. |
| IInvokeProvider | Depends (Abhängig) | Wenn das Element über einen Befehl verfügt, der unabhängig von der Auswahl ausgeführt werden kann, muss das Invoke-Steuerelementmuster implementiert werden. Dies ist normalerweise eine Aktion, die dem Doppelklicken auf das Listenelement-Steuerelement zugeordnet wird. Beispiele wären das Starten eines Dokuments über Windows Explorer oder das Wiederspielen einer Musikdatei in Microsoft Windows Media Player. |
| IScrollItemProvider | Depends (Abhängig) | Wenn das Listenelement in einem Container enthalten ist, der scrollbar ist, muss das ScrollItem-Steuerelementmuster implementiert werden. |
| ISelectionItemProvider | Depends (Abhängig) | Ein Listenelement-Steuerelement, das die Auswahl unterstützt, muss das SelectionItem-Steuerelementmuster implementieren. Dadurch kann die Auswahl eines Listenelement-Steuerelements angezeigt werden. |
| IToggleProvider | Depends (Abhängig) | Wenn das Listenelement überprüft werden kann und die Aktion keine Änderung des Auswahlzustands vorsteuert, muss das Steuerelementmuster "Umschalten" implementiert werden. |
| IValueProvider | Depends (Abhängig) | Wenn das Element bearbeitet werden kann, muss das Value-Steuerelementmuster implementiert werden. Änderungen am Listenelementsteuerelement führen zu Änderungen an den Werten der Eigenschaften UIA _ NamePropertyId und UIA _ ValueValuePropertyId. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die Elementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
Bemerkungen
Wenn ein Container Listenelemente hostet, sollte die primäre Navigationshilfe zu den Listenelementen gehen. Das Platzieren des Fokus auf Unterelemente über die Listennavigation kann für Benutzer und Barrierefreiheitstools verwirrend sein. Wenn der Container eine vertikale Liste von Elementen hostet, sollte durch Drücken der NACH-OBEN-TASTE und DER NACH-UNTEN-TASTE durch die Elemente navigiert werden, aber durch Drücken der NACH-RECHTS-TASTE und DER NACH-LINKS-TASTE können Sie zu Unterelementen des fokussierten Elements navigieren, z. B. Listenspalten oder Benutzeroberflächenunterelemente.