Benutzeroberflächenautomatisierungs-Unterstützung für den HeaderItem-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.
Dieses Thema enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den HeaderItem-Steuerelementtyp. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Der HeaderItem-Steuerelementtyp stellt eine sichtbare Bezeichnung für eine Zeile oder Spalte mit Informationen bereit.
Ein Beispiel für Steuerelemente, die den Steuerelementtyp „HeaderItem“ implementieren, sind Headerelement-Steuerelemente. Die in den folgenden Abschnitten angegebenen Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Header-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 Headerelement-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.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| HeaderItem | Keine |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle enthält die Eigenschaften der Benutzeroberflächenautomatisierung, deren Werte oder Definitionen für Headerelement-Steuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-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. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Siehe Hinweise. | Das Headerelement-Steuerelement ist immer selbstbezeichnend. |
| LabeledByProperty | Null. |
Headerelement-Steuerelemente besitzen keine statische Bezeichnung. |
| ControlTypeProperty | HeaderItem | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Headerelement“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „HeaderItem“. |
| IsContentElementProperty | Falsch | Das Headerelement-Steuerelement ist in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung nicht enthalten. |
| IsControlElementProperty | True | Das Headerelement-Steuerelement ist immer in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| ItemStatusProperty | Siehe Hinweise. | Diese Eigenschaft stellt Informationen für Sortierreihenfolgen nach Headerelement bereit. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
Die folgende Tabelle enthält die Steuerelementmuster der Benutzeroberflächenautomatisierung, die von allen Headerelement-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| ITransformProvider | Depends (Abhängig) | Implementieren Sie dieses Steuerelementmuster, wenn die Größe des Headerelement-Steuerelements geändert werden kann. |
| IInvokeProvider | Depends (Abhängig) | Implementieren Sie dieses Steuerelementmuster, wenn die Daten durch Klicken auf das Headerelement-Steuerelement sortiert werden können. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
Die folgende Tabelle enthält die Ereignisse der Benutzeroberflächenautomatisierung, die von allen Headerelement-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Hinweise |
|---|---|---|
| InvokedEvent | Depends (Abhängig) | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |