Freigeben über

Listensteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Listensteuerelementtyp.

Der Steuerelementtyp List bietet eine Möglichkeit, eine flache Gruppe oder Gruppen von Elementen zu organisieren, und ermöglicht es einem Benutzer, eines oder mehrere dieser Elemente auszuwählen. Der List-Steuerelementtyp hat eine lockere Einschränkung, welche Typen von untergeordneten Elementen er enthalten kann. Dadurch können Benutzeroberflächenautomatisierungs-Anbieter bekannte Elemente für Auswahlcontainer unterstützen.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den List-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Listensteuerelemente, 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 Listensteuerelemente 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
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 von Bedeutung sind.
  • List
    • DataItem (beliebige Anzahl)
    • ListItem (beliebige Anzahl)
    • Group (beliebige Anzahl)
    • ScrollBar (0, 1 oder 2)
  • List
    • DataItem (beliebige Anzahl)
    • ListItem (beliebige Anzahl)
    • Group (beliebige Anzahl)

Die Steuerelementansicht für ein Steuerelement, das den Steuerelementtyp „List“ implementiert (z. B. ein Listensteuerelement), umfasst die folgenden Elemente:

  • Null oder mehr Elemente innerhalb des Listensteuerelements (Elemente können auf den Steuerelementtypen ListItem oder DataItem basieren)
  • Beliebige Anzahl von Gruppensteuerelementen innerhalb eines Listensteuerelements
  • Kein, ein oder zwei ScrollBar-Steuerelemente

Die Inhaltsansicht eines Steuerelements, das den Steuerelementtyp „List“ implementiert (z. B. ein Listensteuerelement), besteht aus folgenden Elementen:

  • Null oder mehr Elemente innerhalb des Listensteuerelements (Elemente können auf den Steuerelementtypen ListItem oder DataItem basieren)
  • Beliebige Anzahl von Gruppen innerhalb des Listensteuerelements

Ein Listensteuerelement darf keine Elemente enthalten, die andere hierarchische Beziehungen als die Gruppierung aufweisen. Wenn die Elemente in der Benutzeroberflächenautomatisierung-Struktur untergeordnete Elemente aufweisen, sollte der Listencontainer auf dem Struktursteuerelementtyp basieren.

Die innerhalb des Listensteuerelements auswählbaren Elemente sind in der Struktur der Benutzeroberflächenautomatisierung des Listensteuerelements über die Nachfolgerelemente verfügbar. Alle Elemente innerhalb des Listensteuerelements müssen zur gleichen Auswahlgruppe gehören. Die auswählbaren Elemente in der Liste sollten als ListItem-Steuerelementtypen (anstelle von DataItem) verfügbar gemacht werden.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für den List-Steuerelementtyp relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere 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-EigenschaftTRUE ist, führt der Versuch, diese Eigenschaft abzurufen, zum UIA_E_NOCLICKABLEPOINT Fehler.
UIA_ControlTypePropertyId Liste
UIA_HelpTextPropertyId Siehe Hinweise. Der Hilfetext für Listensteuerelemente sollte erläutern, warum der Benutzer aufgefordert wird, aus einer Liste von Optionen auszuwählen. Beispiel: „Durch Auswählen eines Elements in dieser Liste wird die Anzeigeauflösung für den Bildschirm festgelegt.“
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 das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
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 List-Steuerelementtyp entspricht. Der Standardwert ist "list" für en-US oder English (USA).
UIA_NamePropertyId Siehe Hinweise. Der Wert der Name-Eigenschaft eines Listensteuerelements sollte die Kategorie der Optionen angeben, aus denen der Benutzer ausgewählt werden soll. Diese Eigenschaft ruft ihren Namen in der Regel aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, muss der Anwendungsentwickler einen Wert für die Name-Eigenschaft verfügbar machen.
Nur wenn das Steuerelement innerhalb der Teilstruktur eines anderen Steuerelements verwendet wird, ist diese Eigenschaft für Listensteuerelemente nicht erforderlich.

Erforderliche Steuerelementmuster und -eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Listensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
IGridProvider Depends (Abhängig) Implementieren Sie das Grid-Steuerelementmuster , wenn die Rasternavigation auf Elementbasis verfügbar sein muss.
IMultipleViewProvider Depends (Abhängig) Implementieren Sie das MultipleView-Steuerelementmuster , wenn das Steuerelement mehrere Ansichten der Elemente im Container unterstützen kann.
IScrollProvider Depends (Abhängig) Implementieren Sie das Scroll-Steuerelementmuster, wenn Elemente im Container scrollbar sind.
ISelectionProvider Depends (Abhängig) Wenn ein Steuerelement den List-Steuerelementtyp unterstützt, der die Auswahl unterstützt, muss das Steuerelement das Selection-Steuerelementmuster implementieren, wenn ein Auswahlzustand zwischen den im Steuerelement enthaltenen Elementen beibehalten wird. Wenn die Elemente innerhalb des Steuerelements nicht ausgewählt werden können, kann der Gruppensteuerelementtyp verwendet werden.
CanSelectMultiple Depends (Abhängig) Listensteuerelemente können Container für Einfach- oder Mehrfachauswahl sein.
IsSelectionRequired Depends (Abhängig) In einem Listensteuerelement muss nicht immer ein Element ausgewählt sein.
ITableProvider Nie Das Table-Steuerelementmuster wird für den List-Steuerelementtyp nie unterstützt. Wenn das Steuerelement dieses Steuerelementmuster unterstützen muss, sollte das Steuerelement auf dem DataGrid-Steuerelementtyp basieren.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Für die Unterstützung von Steuerelementen erforderlich sind. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. 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 Eigenschaft geändertes Ereignis. Wenn das Steuerelement das MultipleView-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis. 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

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung