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

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
  • ListItem
    • Bild (beliebige Anzahl)
    • Text (beliebige Anzahl)
    • Bearbeiten (beliebige Anzahl)
  • ListItem

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.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ ExpandCollapseExpandCollapseStatePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das ExpandCollapse-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ Invoke _ InvokedEventId Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ItemStatusPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die ItemStatus-Eigenschaft unterstützt, muss dieses Ereignis unterstützen.
UIA _ NamePropertyId-Eigenschaftsänderungsereignis.
UIA _ _ SelectionItem-ElementAddedToSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ _ SelectionItem-ElementRemovedFromSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ _ SelectionItem-ElementSelectedEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ StructureChangedEventId
UIA _ ToggleToggleStatePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Umschalten-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ Durch die ValueValuePropertyId-Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

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.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung