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

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

Durch das Header-Steuerelement wird ein visueller Container für Zeilen- oder Spaltenbezeichnungen der Informationen bereitgestellt.

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

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Header-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Header HeaderItem (1 oder mehr)	Keine

Header-Steuerelemente haben immer ein oder mehrere untergeordnete Elemente in der Steuerelementansicht der UI Automation-Struktur.

Header-Steuerelemente haben keine untergeordneten Elemente in der Inhaltsansicht über die UI Automation-Struktur.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Header-Steuerelemente besonders relevant sind. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-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 eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Das Header-Steuerelement benötigt einen Namen, wenn mehr als ein Zeilenheader oder mehr als ein Spaltenheader vorhanden ist. Dadurch werden die Informationen innerhalb des Headers eindeutig identifiziert.
LabeledByProperty	Null.	Header-Steuerelemente verfügen über keine statische Bezeichnung.
ControlTypeProperty	Header	Dieser Wert ist für alle UI-Frameworks identisch.
LocalizedControlTypeProperty	"header"	Dieser Wert ist für alle UI-Frameworks identisch.
OrientationProperty	Horizontal	Der Wert dieser Eigenschaft macht, sowohl bei Zeilen- als auch bei Spaltenheadern, die Position des Header-Steuerelements verfügbar.
IsContentElementProperty	False	Das Header-Steuerelement ist nicht in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das Header-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

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

Steuerelementmuster	Unterstützung	Hinweise
ITransformProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn die Größe des Header-Steuerelements geändert werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

Header

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung