Benutzeroberflächenautomatisierungs-Unterstützung für den ListItem-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp ListItem. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Ein Beispiel für Steuerelemente, die den Steuerelementtyp „ListItem“ implementieren, sind Listenelement-Steuerelemente.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „ListItem“ definiert. Die Anforderungen der Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für ListItem-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| ListItem – Image (0 oder mehr) – Text (0 oder mehr) – Edit (0 oder mehr) |
ListItem |
Die untergeordneten Elemente eines ListItem-Steuerelements innerhalb der Inhaltsansicht der Benutzeroberflächenautomatisierungs-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 Steuerelementtyps Benutzeroberflächenautomatisierungs-Unterstützung für den TreeItem-Steuerelementtyp entsprechen.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für ListItem-Steuerelemente von besonderem Interesse ist. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft sollte den Bereich des Bilds und den Textinhalt des Listenelements enthalten. |
| ClickablePointProperty | 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 durch diese Eigenschaft verfügbar gemacht werden. Wenn das Listensteuerelement vollständig von Nachfolgerlistenelementen abgedeckt ist, wird eine NoClickablePointException ausgelöst, um anzuzeigen, dass der Client von einem Element innerhalb des Listensteuerelements einen klickbaren Punkt anfordern muss. |
| NameProperty | Siehe Hinweise. | Der Wert der Eigenschaft „Name“ eines Listenelement-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 Steuerelementtyp „ListItem“. |
| IsContentElementProperty | True | Das Listensteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| IsControlElementProperty | True | Das Listensteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| IsKeyboardFocusableProperty | True | Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftswert „True“ sein. |
| HelpTextProperty | "" | 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 den Bildschirm festzulegen.“ |
| ItemTypeProperty | 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. |
| IsOffscreenProperty | Depends (Abhängig) | 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 Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von den ListItem-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| ISelectionItemProvider | Ja | Ein Listenelement-Steuerelement muss dieses Steuerelementmuster implementieren. Dadurch kann die Auswahl eines Listenelement-Steuerelements angezeigt werden. |
| IScrollItemProvider | Depends (Abhängig) | Wenn das Listenelement in einem bildlauffähigen Container enthalten ist, muss dieses Steuerelementmuster implementiert werden. |
| IToggleProvider | Depends (Abhängig) | Wenn das Listenelement überprüfbar ist und die Aktion den Auswahlzustand nicht ändert, muss dieses Steuerelementmuster implementiert werden. |
| IExpandCollapseProvider | Depends (Abhängig) | Wenn das Element so geändert werden kann, dass Informationen angezeigt oder ausgeblendet werden, muss dieses Steuerelementmuster implementiert werden. |
| IValueProvider | Depends (Abhängig) | Wenn das Element bearbeitet werden kann, muss dieses Steuerelementmuster implementiert werden. Durch Änderungen am Listenelement-Steuerelement werden die Werte von NamePropertyund Valuegeändert |
| IGridItemProvider | Depends (Abhängig) | 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 | Depends (Abhängig) | 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 Listenelement-Steuerelement zugeordnet wird. Beispiele hierfür wären das Starten eines Dokuments über Microsoft Windows-Explorer oder die Wiedergabe einer Musikdatei in Microsoft Windows Media Player. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen ListItem-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Hinweise |
|---|---|---|
| InvokedEvent | Depends (Abhängig) | Keine |
| ElementAddedToSelectionEvent | Erforderlich | Keine |
| ElementRemovedFromSelectionEvent | Erforderlich | Keine |
| ElementSelectedEvent | Erforderlich | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| NameProperty | Erforderlich | Keine |
| Durch geänderteItemStatusProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteExpandCollapseStateProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteToggleStateProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |