Freigeben über

ListItem-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des ListItem-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

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 Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der 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 Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

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 null untergeordnete Elemente anzeigen. Wenn die Struktur des Steuerelements so ist, dass andere Elemente unter dem Listenelement enthalten sind, sollte es den Anforderungen für die Benutzeroberflächenautomatisierung Unterstützung für den TreeItem-Steuerelementtyp entsprechen.

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 Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. Ordnen Sie die AutomationId-Eigenschaft für ein Listenelement zu, wenn bekannt ist, dass das Element in verschiedenen Instanzen der Benutzeroberfläche 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, gibt es den UIA_E_NOCLICKABLEPOINT Fehler zurück, der angibt, 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 stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsControlElementPropertyId TRUE Das Listensteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung 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 status enthält, die dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Updates empfangen kann, wenn sich die 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 "Listenelement" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Wert der name-Eigenschaft eines Listenelementsteuerelements stammt aus der Textbeschriftung 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 Hinweise
IExpandCollapseProvider Depends (Abhängig) Wenn das Element so bearbeitet werden kann, dass Es Informationen ein- oder ausblenden kann, muss das ExpandCollapse-Steuerelementmuster implementiert werden.
IGridItemProvider Depends (Abhängig) Wenn die räumliche Elementnavigation 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 für das Element ausgeführt werden kann, muss unabhängig von der Auswahl das Invoke-Steuerelementmuster implementiert werden. Dies ist normalerweise eine Aktion, die dem Doppelklicken auf das Listenelement-Steuerelement zugeordnet wird. Beispiele hierfür wären das Starten eines Dokuments von Windows Explorer oder die Wiedergabe einer Musikdatei in Microsoft Windows Medienwiedergabe.
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 Listenelementsteuerelement, 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üfbar ist und die Aktion keine Änderung des Auswahlzustands ausführt, muss das Steuerelementmuster umschalten implementiert werden.
IValueProvider Depends (Abhängig) Wenn das Element bearbeitet werden kann, muss das Wert-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 Ereignisse aufgeführt, die Listenelementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
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ützt werden.
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 Steuerelementmuster "Umschalten" unterstützt, muss es dieses Ereignis unterstützen.
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Bemerkungen

Wenn ein Container Listenelemente hostet, sollte das primäre Navigationsmittel zu den Listenelementen wechseln. Das Setzen des Fokus auf Unterelemente durch 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- und NACH-UNTEN-TASTE durch die Elemente navigieren, aber das Drücken der NACH-RECHTS- und NACH-LINKS-TASTE kann zu Unterelementen des fokussierten Elements navigieren, z. B. Listenspalten oder UI-Unterelemente.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung