DataGrid-Steuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung des DataGrid-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Mit dem DataGrid-Steuerelementtyp können Benutzer problemlos mit Elementen arbeiten, die Daten oder Automatisierungselemente enthalten, die in Spalten oder Zeilen dargestellt werden. Datenraster-Steuerelemente enthalten Zeilen mit Elementen und Spalten mit Informationen über diese Elemente. Ein Listenansicht-Steuerelement in Windows Vista Explorer ist ein Beispiel, das den DataGrid-Steuerelementtyp unterstützt.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den DataGrid-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Datenrastersteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

• Typische Struktur der Struktur
• Relevante Eigenschaften
• Erforderliche Steuerelementmuster
• Erforderliche Ereignisse
• Beispiel für den DataGrid-Steuerelementtyp
• Zugehörige Themen

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Datenrastersteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht	Inhaltsansicht
DataGrid Header (0, 1 oder 2) HeaderItem (Anzahl von Spalten oder Zeilen) DataItem (0 oder mehr; kann in einer Hierarchie strukturiert werden)	DataGrid DataItem (0 oder mehr; kann in einer Hierarchie strukturiert werden)

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den DataGrid-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft	Wert	Hinweise
UIA_AutomationIdPropertyId	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId	Siehe Hinweise.	Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId	Siehe Hinweise.	Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId	DataGrid
UIA_IsContentElementPropertyId	TRUE	Der Wert dieser Eigenschaft muss immer TRUE sein. Dies bedeutet, dass das Datenraster-Steuerelement immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein muss.
UIA_IsControlElementPropertyId	TRUE	Der Wert dieser Eigenschaft muss immer TRUE sein. Dies bedeutet, dass das Datenrastersteuerelement immer in die Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur eingeschlossen werden muss.
UIA_IsKeyboardFocusablePropertyId	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId	Siehe Hinweise.	Wenn eine statische Textbeschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen.
UIA_LocalizedControlTypePropertyId	Siehe Hinweise.	Lokalisierte Zeichenfolge, die dem DataGrid-Steuerelementtyp entspricht. Der Standardwert ist "Datenraster" für en-US oder Englisch (USA).
UIA_NamePropertyId	Siehe Hinweise.	Das Datenrastersteuerelement ruft in der Regel den Wert für seine Name-Eigenschaft aus einer statischen Textbeschriftung ab. Wenn keine statische Textbeschriftung vorhanden ist, muss ein Anwendungsentwickler einen Wert für die Name-Eigenschaft zuweisen. Der Wert der Name-Eigenschaft darf niemals der Textinhalt des Bearbeitungssteuerelements sein.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Datenrastersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster	Support	Hinweise
IGridProvider	Erforderlich	Das Datenrastersteuerelement selbst unterstützt immer das Grid-Steuerelementmuster , da die darin enthaltenen Elemente Metadaten aufweisen, die in einem Raster angeordnet sind.
IScrollProvider	Depends (Abhängig)	Die Möglichkeit, im Datenraster zu scrollen, hängt vom Inhalt und davon ab, ob Scrollleisten vorhanden sind.
ISelectionProvider	Depends (Abhängig)	Die Möglichkeit, das Datenraster auszuwählen, hängt vom Inhalt ab.
ITableProvider	Depends (Abhängig)	Ein Datenrastersteuerelement mit einem Header sollte das Table-Steuerelementmuster unterstützen.

 

Datenelemente im Datenrastercontainer unterstützen mindestens Folgendes:

• SelectionItem-Steuerelementmuster (wenn das Datenraster ausgewählt werden kann)
• ScrollItem-Steuerelementmuster (wenn das Datenraster scrollbar ist)
• GridItem-Steuerelementmuster
• TableItem-Steuerelementmuster (wenn das Datenraster über einen Header verfügt)

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Datenrastersteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung	Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_LayoutInvalidatedEventId
UIA_StructureChangedEventId
UIA_MultipleViewCurrentViewPropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement die CurrentView-Eigenschaft des MultipleView-Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis.	Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Selection_InvalidatedEventId

 

Beispiel für den DataGrid-Steuerelementtyp

Die folgende Abbildung veranschaulicht ein Listenansichtssteuerelement, das den DataGrid-Steuerelementtyp implementiert.

Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf das Listenansicht-Steuerelement bezieht, werden unten angezeigt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt.

Benutzeroberflächenautomatisierungs-Struktur – Steuerelementansicht	Struktur der Benutzeroberflächenautomatisierung – Inhaltsansicht
DataGrid (Sort, Table, Selection, Grid) Header HeaderItem „Name“ (Invoke) HeaderItem „Änderungsdatum“ (Invoke) HeaderItem „Größe“ (Invoke) Gruppe „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) Gruppe „Contoso“ (TableItem, GridItem, SelectionItem, Table*, Grid*) DataItem „Accounts Receivable.doc“ (SelectionItem, Invoke, TableItem*, GridItem*) DataItem „Accounts Payable.doc“ (SelectionItem, Invoke, TableItem*, GridItem*)

 

*Das vorherige Beispiel zeigt ein Datenraster, das mehrere Steuerelementebenen enthält. Das Group ("Contoso")-Steuerelement enthält zwei DataItem-Steuerelemente ("Konten Receivable.doc" und "Konten 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, sodass sie besser als auswählbare Objekte statt als einfache Datenelemente dargestellt werden können. Dieses Beispiel enthält nicht die Unterelemente der gruppierten Datenelemente. Ein weiteres Beispiel für mehrere Ebenen von Steuerelementen finden Sie unter DataItem-Steuerelementtyp .

Zugehörige Themen

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung