Benutzeroberflächenautomatisierungs-Unterstützung für den ListItem-Steuerelementtyp

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den ListItem Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Ein Beispiel für Steuerelemente, die den ListItem-Steuerelementtyp implementieren, sind ListItem-Steuerelemente.

In den folgenden Abschnitten werden die UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den ListItem-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listen-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf ListItem-Steuerelemente bezieht, dargestellt und werden die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
ListItem Bild (beliebige Anzahl) Text (beliebige Anzahl) Edit (mindestens 0)	ListItem

Die untergeordneten Elemente eines ListItem-Steuerelements innerhalb der Inhaltsansicht der UI Automation-Struktur müssen immer "0" sein. Wenn das Steuerelement so aufgebaut ist, dass sich unterhalb des Listenelements andere Elemente befinden, sollte es den Anforderungen des TreeItem-Steuerelementtyps (siehe Benutzeroberflächenautomatisierungs-Unterstützung für den TreeItem-Steuerelementtyp) entsprechen.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für die ListItem-Steuerelemente besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft sollte den Bereich des Bilds und den Textinhalt des Listenelements enthalten.
ClickablePointProperty	Variabel	Wenn das Listen-Steuerelement über einen klickbaren Punkt verfügt (ein Punkt, auf den geklickt werden kann, damit die Liste den Fokus erhält), muss dieser Punkt durch diese Eigenschaft verfügbar gemacht werden. Wenn das Listen-Steuerelement vollständig von Nachfolgerlistenelementen abgedeckt ist, wird eine NoClickablePointException ausgelöst, um anzuzeigen, dass der Client von einem Element innerhalb des Listen-Steuerelements einen klickbaren Punkt anfordern muss.
NameProperty	Siehe Hinweise.	Der Wert der Name-Eigenschaft eines ListItem-Steuerelements wird vom Textinhalt des Elements abgeleitet.
LabeledByProperty	Siehe Hinweise.	Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.
ControlTypeProperty	ListItem	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"Listenelement"	Lokalisierte Zeichenfolge für den ListItem-Steuerelementtyp.
IsContentElementProperty	True	Das Listen-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das Listen-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.
IsKeyboardFocusableProperty	True	Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftswert True sein.
HelpTextProperty	""	Im Hilfetext für Listen-Steuerelemente sollte erklärt werden, warum der Benutzer aufgefordert wird, eine Auswahl aus einer Liste von Optionen zu treffen. Dies entspricht im Allgemeinen dem Typ der durch eine QuickInfo präsentierten Informationen. Beispiel: "Wählen Sie ein Element aus, um die Anzeigeauflösung für den Bildschirm festzulegen."
ItemTypeProperty	Variabel	Diese Eigenschaft sollte für ListItem-Steuerelemente verfügbar gemacht werden, die ein zugrunde liegendes Objekt darstellen. Bei diesen ListItem-Steuerelementen ist dem Steuerelement normalerweise ein Symbol zugeordnet, das Benutzer mit dem zugrunde liegenden Objekt assoziieren.
IsOffscreenProperty	Variabel	Diese Eigenschaft muss einen Wert zurückgeben, der angibt, ob das Listenelement innerhalb des übergeordneten Containers, der das Scroll-Steuerelementmuster implementiert, derzeit durch einen Bildlauf angezeigt wird.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgelistet, die von allen ListItem-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster	Unterstützung	Hinweise
ISelectionItemProvider	Ja	Ein ListItem-Steuerelement muss dieses Steuerelementmuster implementieren. Dadurch kann die Auswahl eines ListItem-Steuerelements angezeigt werden.
IScrollItemProvider	Variabel	Wenn das Listenelement in einem bildlauffähigen Container enthalten ist, muss dieses Steuerelementmuster implementiert werden.
IToggleProvider	Variabel	Wenn das Listenelement überprüfbar ist und die Aktion den Auswahlzustand nicht ändert, muss dieses Steuerelementmuster implementiert werden.
IExpandCollapseProvider	Variabel	Wenn das Element so geändert werden kann, dass Informationen angezeigt oder ausgeblendet werden, muss dieses Steuerelementmuster implementiert werden.
IValueProvider	Variabel	Wenn das Element bearbeitet werden kann, muss dieses Steuerelementmuster implementiert werden. Durch Änderungen am ListItem-Steuerelement werden die Werte von NameProperty und Value geändert.
IGridItemProvider	Variabel	Wenn innerhalb des Listencontainers die räumliche Navigation zwischen Elementen unterstützt wird und der Container in Zeilen und Spalten aufgeteilt ist, muss das GridItem-Steuerelementmuster implementiert werden.
IInvokeProvider	Variabel	Wenn für das Element ein Befehl existiert, der für dieses durchgeführt werden kann (abgesehen von der Auswahl), muss dieses Steuerelementmuster implementiert werden. Dies ist normalerweise eine Aktion, die dem Doppelklicken auf das ListItem-Steuerelement zugeordnet wird. Beispiele sind das Aufrufen eines Dokuments aus Microsoft Windows Explorer oder das Wiedergeben einer Musikdatei in Microsoft Windows Media Player.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen ListItem-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
InvokedEvent	Variabel	Keine
ElementAddedToSelectionEvent	Erforderlich	Keine
ElementRemovedFromSelectionEvent	Erforderlich	Keine
ElementSelectedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
NameProperty	Erforderlich	Keine
Durch geänderte ItemStatusProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

ListItem

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung