Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieses Thema enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Header-Steuerelementtyp. Bei der Benutzeroberflächenautomatisierung ist ein Steuerelementtyp eine 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 Baumstruktur der UI Automation, Eigenschaftswerte der UI Automation und Steuermuster.
Das Kopfzeilensteuerelement stellt einen visuellen Container für die Beschriftungen für Zeilen oder Spalten von Informationen bereit.
In den folgenden Abschnitten werden die erforderliche UI-Automatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Header-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Headersteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Header-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Kopfzeile - HeaderItem (1 oder mehr) |
Nichts |
Header-Steuerelemente haben immer mindestens ein untergeordnetes Element in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur.
Kopfzeilensteuerelemente verfügen über null untergeordnete Elemente in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Kopfzeilensteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften 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ßerste Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. 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 Kopfzeilensteuerelement benötigt einen Namen, wenn mehrere Zeilenüberschriften oder mehrere Spaltenüberschriften vorhanden sind. Dadurch werden die Informationen in der Kopfzeile identifiziert. |
| LabeledByProperty |
Null. |
Kopfzeilensteuerelemente verfügen nicht über eine statische Beschriftung. |
| ControlTypeProperty | Kopfzeile | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| LocalizedControlTypeProperty | „Header“ | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| OrientationProperty | Horizontal | Der Wert dieser Eigenschaft macht die Position des Headersteuerelements verfügbar, egal, ob es eine Zeilen- oder eine Spaltenüberschrift ist. |
| IsContentElementProperty | Falsch | Das Kopfzeilensteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| IsControlElementProperty | Richtig | Das Kopfzeilensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Kopfzeilensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützung | Hinweise |
|---|---|---|
| ITransformProvider | Hängt | Implementieren Sie dieses Steuerelementmuster, wenn die Größe des Headersteuerelements geändert werden kann. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Headersteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Unterstützung | Hinweise |
|---|---|---|
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |