Benutzeroberflächenautomatisierungs-Unterstützung für den DataGrid-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
In diesem Thema erhalten Sie Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Steuerelementtyp „DataGrid“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlType-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Der DataGrid-Steuerelementtyp ermöglicht dem Benutzer einfaches Arbeiten mit Elementen, die Metadaten enthalten, die in Spalten dargestellt werden. Datenraster-Steuerelemente enthalten Zeilen mit Elementen und Spalten mit Informationen über diese Elemente. Ein Listenansicht-Steuerelement in Microsoft Vista Explorer ist ein Beispiel, für das der DataGrid-Steuerelementtyp unterstützt wird.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „DataGrid“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Datenraster-Steuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Datenraster-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Benutzeroberflächenautomatisierungs-Struktur – Steuerelementansicht | Benutzeroberflächenautomatisierungs-Struktur – Inhaltsansicht |
|---|---|
DataGrid
|
DataGrid - DataItem (0 oder mehr, kann hierarchisch strukturiert werden) |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die Eigenschaften aufgelistet, deren Werte oder Definitionen für Datenratser-Steuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht auf jeden Punkt innerhalb des umschließenden Rechtecks geklickt werden kann, und Sie spezielle Treffertests ausführen, setzen Sie die Eigenschaft außer Kraft, und stellen Sie dann einen klickbaren Punkt bereit. |
| ControlTypeProperty | DataGrid | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| IsContentElementProperty | True | Diese Eigenschaft muss immer den Wert „True“ haben. Dies bedeutet, dass das Datenraster-Steuerelement immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein muss. |
| IsControlElementProperty | True | Diese Eigenschaft muss immer den Wert „True“ haben. Dies bedeutet, dass das Datenraster-Steuerelement immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 für den Steuerelementtyp „DataGrid“. |
| NameProperty | Siehe Hinweise. | Das Datenraster-Steuerelement ruft in der Regel den Wert für seine Name -Eigenschaft aus einer statischen Textbezeichnung ab. Ist keine statische Textbezeichnung vorhanden, muss ein Anwendungsentwickler einen Wert für die Name -Eigenschaft zuweisen. Der Wert der Name -Eigenschaft darf nie der Textinhalt des Bearbeitungssteuerelements sein. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle werden die Steuerelementmuster aufgelistet, die von allen Datenraster-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| IGridProvider | Ja | Das Datenraster-Steuerelement selbst unterstützt immer das Raster-Steuerelementmuster (Grid), da die in ihm enthaltenen Elemente Metadaten sind, 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 | Yes | Das Datenrarster-Steuerelement hat immer einen Header in seiner Unterstruktur, sodass das Table-Steuerelementmuster unterstützt werden muss. |
Datenelemente im Datenrastercontainer unterstützen mindestens Folgendes:
SelectionItem-Steuerelementmuster (wenn das Datenraster ausgewählt werden kann)
ScrollItem-Steuerelementmuster (wenn im Datenraster gescrollt werden kann)
GridItem-Steuerelementmuster
TableItem-Steuerelementmuster
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Datenraster-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Notizen |
|---|---|---|
| AutomationFocusChangedEvent | Erforderlich | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| LayoutInvalidatedEvent | Depends (Abhängig) | Keine |
| StructureChangedEvent | Erforderlich | Keine |
| Durch geänderteCurrentViewProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch geänderteHorizontalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch geänderteHorizontalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch geänderteVerticalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch geänderteVerticallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| Durch geänderteVerticalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Wenn das Steuerelement das Scroll-Muster unterstützt, muss es dieses Ereignis unterstützen. |
| InvalidatedEvent | Erforderlich | Keine |
Beispiel für DataGrid-Steuerelementtyp
Das folgende Bild zeigt ein Listenansicht-Steuerelement, für das der DataGrid-Steuerelementtyp implementiert ist.
Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die zur Listenansicht gehört, werden unten dargestellt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt.
| Benutzeroberflächenautomatisierungs-Struktur – Steuerelementansicht | Benutzeroberflächenautomatisierungs-Struktur – Inhaltsansicht |
|---|---|
|
|
* Im vorangehenden Beispiel ist ein Datenraster (DataGrid) gezeigt, das mehrere Ebenen von Steuerelementen enthält. Das Gruppensteuerelement („Contoso“) enthält zwei Datenelement-Steuerelemente („Accounts Receivable.doc“ und „Accounts Payable.doc“). Ein DataGrid/GridItem-Paar ist unabhängig von einem Paar auf einer anderen Ebene. Die Datenelement-Steuerelemente (DataItem) unter einer Gruppe können auch, statt als einfache Datenelemente, als ListItem-Steuerelementtyp verfügbar gemacht werden, wodurch sie deutlicher als auswählbare Objekte dargestellt werden können. Dieses Beispiel enthält nicht die Unterelemente der gruppierten Datenelemente.