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

Artikel
08/10/2011

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 DataGrid-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlType-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Der DataGrid-Steuerelementtyp erlaubt dem Benutzer das einfache Arbeiten mit Elementen, die Metadaten in Spalten enthalten. DataGrid-Steuerelemente enthalten Zeilen mit Elementen, und Spalten mit Informationen über diese Elemente. Ein Beispiel für ein Element, das den DataGrid-Steuerelementtyp unterstützt, ist das ListView-Steuerelement in Microsoft Vista Explorer.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den DataGrid-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle DataGrid-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
Beispiel für einen DataGrid-Steuerelementtyp
Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf DataGrid-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
DataGrid Header (0, 1 oder 2) HeaderItem (Anzahl der Spalten oder Zeilen) DataItem (0 oder mehr, kann hierarchisch strukturiert werden)	DataGrid DataItem (0 oder mehr, kann hierarchisch strukturiert werden)

DataGrid

Header (0, 1 oder 2)
- HeaderItem (Anzahl der Spalten oder Zeilen)
DataItem (0 oder mehr, kann hierarchisch strukturiert werden)

DataGrid

DataItem (0 oder mehr, kann hierarchisch strukturiert werden)

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die Eigenschaften aufgelistet, deren Wert oder Definition für DataGrid-Steuerelemente besonders relevant ist. Weitere Informationen zu UI Automationseigenschaften 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.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	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.
ControlTypeProperty	DataGrid	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
IsContentElementProperty	True	Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das DataGrid-Steuerelement immer in der Inhaltsansicht der UI Automation-Struktur enthalten sein muss.
IsControlElementProperty	True	Der Wert dieser Eigenschaft muss immer True sein. Das bedeutet, dass das DataGrid-Steuerelement immer in der Steuerelementansicht der UI Automation-Struktur enthalten sein muss.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
LabeledByProperty	Siehe Hinweise.	Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.
LocalizedControlTypeProperty	"Datenraster"	Lokalisierte Zeichenfolge, die dem DataGrid-Steuerelementtyp entspricht.
NameProperty	Siehe Hinweise.	Das DataGrid-Steuerelement ruft in der Regel den Wert für seine Name-Eigenschaft von einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, muss der Anwendungsentwickler einen Wert für die Name-Eigenschaften zuweisen. Der Wert der Name-Eigenschaft darf nie der Textinhalt des Bearbeitungssteuerelements sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

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

Steuerelementmuster	Unterstützung	Hinweise
IGridProvider	Ja	Das DataGrid-Steuerelement selbst unterstützt immer das Grid-Steuerelementmuster, da die enthaltenen Elemente über Metadaten verfügen, die in einem Raster angeordnet sind.
IScrollProvider	Variabel	Die Möglichkeit, im DataGrid einen Bildlauf durchzuführen, hängt vom Inhalt und davon ab, ob Bildlaufleisten vorhanden sind.
ISelectionProvider	Variabel	Die Möglichkeit zum Auswählen des Datenrasters ist abhängig vom Inhalt.
ITableProvider	Ja	Das DataGrid-Steuerelement verfügt immer über einen Header in der Teilstruktur, sodass das Table-Steuerelementmuster unterstützt werden muss.

Datenelemente innerhalb des DataGrid-Containers unterstützen mindestens Folgendes:

SelectionItem-Steuerelementmuster (wenn das Datenraster ausgewählt werden kann)
ScrollItem-Steuerelementmuster (wenn im Datenraster ein Bildlauf ausgeführt werden kann)
GridItem-Steuerelementmuster
TableItem-Steuerelementmuster

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
AutomationFocusChangedEvent	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
LayoutInvalidatedEvent	Variabel	Keine
StructureChangedEvent	Erforderlich	Keine
Durch geänderte CurrentViewProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Wenn das Steuerelement das Bildlaufmuster unterstützt, muss es dieses Ereignis unterstützen.
InvalidatedEvent	Erforderlich	Keine

Beispiel für einen DataGrid-Steuerelementtyp

Das folgende Bild zeigt ein ListView-Steuerelement, das den DataGrid-Steuerelementtyp implementiert.

Grafik eines Listenansichtssteuerelements mit zwei Datenelementen

Die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die zum ListView-Steuerelement gehören, sind unten dargestellt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt.

UI Automation-Struktur - Steuerelementansicht	UI Automation-Struktur - Inhaltsansicht
DataGrid (Table, Grid, Selection) Header HeaderItem "Name" (Invoke) HeaderItem "Datum geändert" (Invoke) HeaderItem "Größe" (Invoke) Group "Contoso" (TableItem, GridItem, SelectionItem, Table, Grid) DataItem "Accounts Receivable.doc" (SelectionItem, Invoke, TableItem, GridItem) DataItem "Accounts Payable.doc" (SelectionItem, Invoke, TableItem, GridItem)	DataGrid (Table, Grid, Selection) Group "Contoso" (TableItem, GridItem, SelectionItem, Table, Grid) DataItem "Accounts Receivable.doc" (SelectionItem, Invoke, TableItem, GridItem) DataItem "Accounts Payable.doc" (SelectionItem, Invoke, TableItem, GridItem)

* Im vorangehenden Beispiel wird ein DataGrid mit mehreren Ebenen von Steuerelementen veranschaulicht. Das Group ("Contoso")-Steuerelement enthält zwei DataItem-Steuerelemente ("Accounts Receivable.doc" und "Accounts Payable.doc"). Ein DataGrid/GridItem-Paar ist unabhängig von einem Paar auf einer anderen Ebene. Die DataItem-Steuerelemente unter einer Gruppe können auch als ListItem-Steuerelementtyp verfügbar gemacht werden. So können sie deutlicher als auswählbare Objekte darstellt werden und nicht als einfache Datenelemente. Dieses Beispiel enthält nicht die Unterelemente der gruppierten Datenelemente.