Benutzeroberflächenautomatisierungs-Unterstützung für den DataItem-Steuerelementtyp
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die Microsoft-UI-Automatisierung-Unterstützung für den DataItem-Steuerelementtyp. In UI-Automatisierung besteht ein Steuerelementtyp aus einer 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 Eintrag in einer Kontaktliste ist ein Beispiel für ein DataItem-Steuerelement. Ein DataItem-Steuerelement enthält Informationen, die für einen Endbenutzer von Interesse sind. Es ist komplizierter als das einfache ListItem-Steuerelement, da es mehr Informationen enthält.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den DataItem-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle DataItem-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
- Arbeiten mit DataItem-Steuerelementen in umfangreichen Listen
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Beispiel für DataItem-Steuerelementtyp
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf DataItem-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
UI-Automatisierung-Struktur - Steuerelementansicht |
UI-Automatisierung-Struktur - Inhaltsansicht |
|---|---|
|
|
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die Eigenschaften aufgelistet, deren Wert oder Definition für DataItem-Steuerelemente besonders relevant ist. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
Siehe Hinweise. |
Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, überschreiben Sie diese Eigenschaft, und geben Sie einen durch Klicken aktivierbaren Punkt an. |
|
DataItem |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
True |
Das DataItem-Steuerelement muss stets ein Inhaltselement sein. |
|
True |
Das DataItem-Steuerelement muss stets ein Steuerelement sein. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Wenn das Steuerelement einen 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. |
|
Siehe Hinweise. |
Dies ist der Zeichenfolgenwert, der dem Endbenutzer das zugrunde liegende Objekt übermittelt, das vom Element dargestellt wird. Beispiele sind "Mediendatei" oder "Kontakt". |
|
Null |
DataItem-Steuerelemente verfügen nicht über eine statische Textbezeichnung. |
|
"Datenelement" |
Lokalisierte Zeichenfolge, die dem DataItem-Steuerelementtyp entspricht. |
|
Siehe Hinweise. |
Das DataItem-Steuerelement enthält stets ein primäres Textelement, das sich auf den Bezeichner bezieht, den der Benutzer als bedeutungsvollsten Bezeichner für das Element assoziieren würde. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle werden die Microsoft-UI-Automatisierung-Steuerelementmuster aufgelistet, die von allen DataItem-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 |
|---|---|---|
Variabel |
Wenn das DataItem-Steuerelement erweitert oder reduziert werden kann, um Informationen ein- bzw. auszublenden, muss das ExpandCollapse-Muster unterstützt werden. |
|
Variabel |
DataItem-Steuerelemente unterstützen das GridItem-Muster, wenn in einem Container, in dem eine räumliche Navigation von Element zu Element möglich ist, eine Auflistung von DataItem-Steuerelementen verfügbar ist. |
|
Variabel |
Alle DataItem-Steuerelemente können mithilfe des ScrollItem-Musters durch einen Bildlauf angezeigt werden, wenn ihr Datencontainer mehr Elemente enthält, als auf den Bildschirm passen. |
|
Ja |
Alle DataItem-Steuerelemente müssen das SelectionItem-Muster unterstützen, das anzeigt, ob das Element ausgewählt ist. |
|
Variabel |
Wenn das DataItem-Steuerelement in einem DataGrid-Steuerelementtyp enthalten ist, wird dieses Muster unterstützt. |
|
Variabel |
Wenn das DataItem-Steuerelement einen Zustand enthält, dessen Werte durchlaufen werden können. |
|
Variabel |
Wenn der primäre Text des DataItem-Steuerelements bearbeitbar ist, muss das Value-Muster unterstützt werden. |
Arbeiten mit DataItem-Steuerelementen in umfangreichen Listen
Bei umfangreichen Listen handelt es sich häufig um Daten, die in -Frameworks virtualisiert sind, um die Leistung zu verbessern. Aus diesem Grund kann ein Benutzeroberflächenautomatisierungsclient die UI-Automatisierung-Abfragefeature nicht dazu verwenden, den Inhalt der gesamten Struktur auf die gleiche Weise abzurufen wie den anderer Elementcontainer. Ein Client muss das Element per Bildlauf anzeigen, bevor er auf sämtliche Informationen des DataItem-Steuerelements zugreifen kann.
Wird SetFocus im UI-Automatisierung-Element für das DataItem-Steuerelement aufgerufen, wird der Microsoft Windows Explorer-Aufruf erfolgreich abgeschlossen, und der Fokus wechselt zu dem Edit-Element innerhalb der Teilstruktur des DataItem-Steuerelements.
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgelistet, die von allen DataItem-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis. |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Variabel |
Keine |
|
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis. |
Variabel |
Keine |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis. |
Variabel |
Keine |
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis. |
Variabel |
Keine |
Beispiel für DataItem-Steuerelementtyp
Das folgende Bild zeigt einen DataItem-Steuerelementtyp in einem ListView-Steuerelement.
.gif)
Die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die zum DataItem-Steuerelement gehören, werden unten dargestellt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt.
UI-Automatisierung-Struktur - Steuerelementansicht |
UI-Automatisierung-Struktur - Inhaltsansicht |
|---|---|
DataItem (Sort, Table, Selection, Grid)
|
DataItem (Sort, Table, Selection, Grid)
|
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung