Benutzeroberflächenautomatisierungs-Unterstützung für den ListItem-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ListItemSteuerelementtyp. In UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.
Ein Beispiel für Steuerelemente, die den ListItem-Steuerelementtyp implementieren, sind ListItem-Steuerelemente.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den ListItem-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf ListItem-Steuerelemente bezieht, dargestellt und werden die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Die untergeordneten Elemente eines ListItem-Steuerelements innerhalb der Inhaltsansicht der UI-Automatisierung-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-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für die ListItem-Steuerelemente besonders wichtig sind. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Der Wert dieser Eigenschaft sollte den Bereich des Bilds und den Textinhalt des Listenelements enthalten. |
|
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. |
|
Siehe Hinweise. |
Der Wert der Name-Eigenschaft eines ListItem-Steuerelements wird vom Textinhalt des Elements abgeleitet. |
|
Siehe Hinweise. |
Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
|
ListItem |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Listenelement" |
Lokalisierte Zeichenfolge für den ListItem-Steuerelementtyp. |
|
True |
Das Listen-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Das Listen-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Wenn der Container Tastatureingaben akzeptieren kann, sollte dieser Eigenschaftenwert True sein. |
|
"" |
Der Hilfetext für Listen-Steuerelemente 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 festlegt." |
|
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. |
|
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-Automatisierung-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/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Ja |
Ein ListItem-Steuerelement muss dieses Steuerelementmuster implementieren. Dadurch kann die Auswahl eines ListItem-Steuerelements angezeigt werden. |
|
Variabel |
Wenn das Listenelement in einem bildlauffähigen Container enthalten ist, muss dieses Steuerelementmuster implementiert werden. |
|
Variabel |
Wenn das Listenelement überprüfbar ist und die Aktion den Auswahlzustand nicht ändert, muss dieses Steuerelementmuster implementiert werden. |
|
Variabel |
Wenn das Element so geändert werden kann, dass Informationen angezeigt oder ausgeblendet werden, muss dieses Steuerelementmuster implementiert werden. |
|
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. |
|
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. |
|
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-Automatisierung-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-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Variabel |
Keine |
|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis. |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes ItemStatusProperty-Ereignis. |
Variabel |
Keine |
Durch geänderte Eigenschaft ausgelöstes ExpandCollapseStateProperty-Ereignis. |
Variabel |
Keine |
Durch geänderte Eigenschaft ausgelöstes ValueProperty-Ereignis. |
Variabel |
Keine |
Durch geänderte Eigenschaft ausgelöstes ToggleStateProperty-Ereignis. |
Variabel |
Keine |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung