Freigeben über

ListItem-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der 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 erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ListItem- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Listenelementsteuerelemente, 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 Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Listenelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • ListItem
    • Bild (0 oder mehr)
    • Text (0 oder mehr)
    • Bearbeiten (0 oder mehr)
  • ListItem

 

Die untergeordneten Elemente eines Listenelementsteuerelements in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur müssen immer null untergeordnete Elemente anzeigen. Wenn die Struktur des Steuerelements so ist, dass andere Elemente unter dem Listenelement enthalten sind, sollte sie die Anforderungen für die Benutzeroberflächenautomatisierungs-Unterstützung für den TreeItem- Steuerelementtyp erfüllen.

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den ListItem- Steuerelementtyp 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. Weisen Sie die AutomationId-Eigenschaft für ein Listenelement zu, wenn das Element bekannt ist, dass es 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. Dieser Wert dieser Eigenschaft sollte den Bereich des Bilds und des Textinhalts des Listenelements enthalten.
UIA_ClickablePointPropertyId Hängt 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 untergeordneten Listenelementen abgedeckt ist, 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ächenframeworks identisch.
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, bei der es sich in der Regel um denselben Informationstyp handelt, der über eine QuickInfo dargestellt wird. 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ächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE- Das Listensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftswert TRUEsein.
UIA_IsOffscreenPropertyId Hängt Diese Eigenschaft muss einen Wert zurückgeben, der angibt, ob das Listenelement derzeit im übergeordneten Container angezeigt wird, der Scroll Steuerelementmuster implementiert.
UIA_ItemStatusPropertyId Hängt Wenn das Steuerelement den Status enthält, der dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Aktualisierungen empfangen kann, wenn sich der Status des Elements ändert.
UIA_ItemTypePropertyId Hängt Diese Eigenschaft sollte für Listenelementsteuerelemente verfügbar gemacht werden, die ein zugrunde liegendes Objekt darstellen. Diese Listenelementsteuerelemente weisen in der Regel ein Symbol auf, das benutzern dem zugrunde liegenden Objekt zugeordnet ist.
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 ListItem entspricht. Der Standardwert ist "Listenelement" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Wert der Namenseigenschaft eines Listenelementsteuerelements stammt aus der Textbeschriftung des Elements.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Listenelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützen Notizen
IExpandCollapseProvider Hängt Wenn das Element so bearbeitet werden kann, dass Informationen angezeigt oder ausgeblendet werden, muss das ExpandCollapse- Steuerelementmuster implementiert werden.
IGridItemProvider- Hängt Wenn die räumliche Navigation zwischen Element und Element im Listencontainer unterstützt wird und der Container in Zeilen und Spalten angeordnet ist, muss das GridItem- Steuerelementmuster implementiert werden.
IInvokeProvider- Hängt Wenn das Element über einen Befehl verfügt, der unabhängig von der Auswahl ausgeführt werden kann, muss das Aufrufen Steuerelementmusters implementiert werden. Dies ist in der Regel eine Aktion, die mit dem Doppelklicken auf das Listenelementsteuerelement verknüpft ist. Beispiele wären das Starten eines Dokuments aus dem Windows-Explorer oder das Wiedergeben einer Musikdatei in Microsoft Windows Media Player.
IScrollItemProvider- Hängt Wenn das Listenelement in einem Container enthalten ist, der scrollbar ist, muss das ScrollItem- Steuerelementmuster implementiert werden.
ISelectionItemProvider- Hängt Ein Listenelementsteuerelement, das die Auswahl unterstützt, muss das SelectionItem Steuerelementmuster implementieren. Auf diese Weise können Listenelementesteuerelemente vermitteln, wenn sie ausgewählt werden.
IToggleProvider- Hängt Wenn das Listenelement überprüfbar ist und die Aktion keine Änderung des Auswahlzustands ausführt, muss das Umschalten Steuerelementmusters implementiert werden.
IValueProvider- Hängt 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ächenautomatisierungsereignisse aufgeführt, die Listenelementsteuerelemente 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_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 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_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 Umschalten Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Bemerkungen

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

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung