Benutzeroberflächenautomatisierungs-Unterstützung für den DataItem-Steuerelementtyp
.gif "Hinweis") 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 Microsoft UI Automation-Unterstützung für den DataItem-Steuerelementtyp. In UI Automation 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 Automation-Struktur, UI Automation-Eigenschaftswerte 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 Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den DataItem-Steuerelementtyp erforderlich sind. Die UI Automation-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 Automation-Struktur, die sich auf DataItem-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
UI Automation-Struktur - Steuerelementansicht |
UI Automation-Struktur - Inhaltsansicht |
|---|---|
DataItem
|
DataItem
|
Ein Datenelementelement in einem Datenraster kann eine Vielzahl von Objekten hosten, wie etwa eine andere Ebene von Datenelementen oder bestimmte Rasterelemente, z. B. Text, Bilder oder Bearbeitungssteuerelemente. Wenn das Datenelementelement über eine bestimmte Objektrolle verfügt, muss das Element als bestimmter Steuerelementtyp verfügbar gemacht werden, z. B. als ListItem-Steuerelementtyp für ein wählbares Datenelement im Raster.
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 UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
Eigenschaft |
Wert |
Hinweise |
|---|---|---|
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 einen speziellen Treffertest 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 Automation-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 |
Unterstützung |
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 Automation-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 (oder das Steuerelement erweitern, um alle hilfreichen Optionen anzuzeigen), bevor er auf sämtliche Informationen des DataItem-Steuerelements zugreifen kann.
Wird SetFocus im UI Automation-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 Automation-Ereignisse aufgelistet, die von allen DataItem-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI Automation-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 mit Unterstützung für detaillierte Informationen für die Spalten.
.gif "Grafik eines Listenansichtssteuerelements mit zwei Datenelementen")
Die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die zum DataItem-Steuerelement gehören, werden unten dargestellt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt. Die Gruppe "Contoso" ist ebenfalls Teil des Rasters des DataGrid-Hoststeuerelements.
UI Automation-Struktur - Steuerelementansicht |
UI Automation-Struktur - Inhaltsansicht |
|---|---|
|
|
Wenn ein Raster eine Liste wählbarer Elemente darstellt, können die entsprechenden Benutzeroberflächenelemente mit dem ListItem-Steuerelementtyp statt mit dem DataItem-Steuerelementtyp verfügbar gemacht werden. Im vorherigen Beispiel können die DataItem-Elemente ("Accounts Receivable.doc" und "Accounts Payable.doc") unter Gruppe ("Contoso") verbessert werden, wenn Sie diese als ListItem-Steuerelementtypen verfügbar machen, da dieser Typ bereits das SelectionItem-Steuerelementmuster unterstützt.
Siehe auch
Referenz
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung