Benutzeroberflächenautomatisierungs-Unterstützung für den Pane-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 Pane-Steuerelementtyp. In 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.

Der Pane-Steuerelementtyp dient der Darstellung eines Objekts innerhalb eines Rahmens oder Dokumentfensters. Benutzer können zwischen Pane-Steuerelementen und im Inhalt des aktuellen Bereichs navigieren, jedoch nicht zwischen Elementen in unterschiedlichen Bereichen. Daher stellen Pane-Steuerelemente eine Gruppierungsebene dar, die sich unterhalb von Fenstern oder Dokumenten, jedoch oberhalb einzelner Steuerelemente befindet. Der Benutzer navigiert zwischen Bereichen je nach Kontext mit der TAB-TASTE, F6 oder STRG+TAB. Für den Pane-Steuerelementtyp ist keine bestimmte Tastaturnavigation erforderlich.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Pane-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listensteuerelemente, d. h. für Steuerelemente der Typen Windows Presentation Foundation (WPF), Win32 und Windows Forms.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Beispiel für den Pane-Steuerelementtyp
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Pane-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
Bereich	Pane

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Pane-Steuerelemente besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften 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.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Der Wert für diese Eigenschaft muss stets ein klarer, präziser und sinnvoller Titel sein.
ClickablePointProperty	Siehe Hinweise.	Diese Eigenschaft macht einen anklickbaren Punkt des Pane-Steuerelements verfügbar, durch den der Bereich den Fokus erhält, wenn darauf geklickt wird.
LabeledByProperty	Siehe Hinweise.	Pane-Steuerelemente haben normalerweise keine statische Bezeichnung. Wenn eine statische Textbezeichnung vorhanden ist, sollte sie über diese Eigenschaft verfügbar gemacht werden.
ControlTypeProperty	Bereich	Dieser Wert ist für alle UI-Frameworks identisch.
LocalizedControlTypeProperty	"Bereich"	Lokalisierte Zeichenfolge, die dem Pane-Steuerelementtyp entspricht.
IsContentElementProperty	True	Pane-Steuerelemente sind stets in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Pane-Steuerelemente sind stets in der Steuerelementansicht der UI Automation-Struktur enthalten.
HelpTextProperty	""	Der Hilfetext für Pane-Steuerelemente sollte erklären, welchem Zweck der Rahmen dient und in welcher Beziehung er zu anderen Rahmen steht. Eine Beschreibung ist erforderlich, wenn der Verwendungszweck und die Beziehung von Rahmen nicht aus dem NameProperty-Wert ersichtlich sind. "
AccessKeyProperty	Siehe Hinweise.	Wenn der Bereich mittels einer bestimmten Tastenkombination den Fokus erhält, sollte diese Information über diese Eigenschaft verfügbar gemacht werden.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgeführt, die von allen Pane-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 das Pane-Steuerelement auf dem Bildschirm verschoben, gedreht oder in der Größe verändert werden kann.
IWindowProvider	Nie	Wenn Sie dieses Steuerelementmuster implementieren müssen, sollte das Steuerelement auf dem Window-Steuerelementtyp basieren.
IDockProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn das Pane-Steuerelement angedockt werden kann.
IScrollProvider	Variabel	Implementieren Sie dieses Steuerelementmuster, wenn für das Pane-Steuerelement ein Bildlauf ausgeführt werden kann.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung/Wert	Hinweise
WindowClosedEvent	Nie	Keine
WindowOpenedEvent	Nie	Keine
AsyncContentLoadedEvent	Erforderlich	Keine
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
Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
Durch geänderte WindowVisualStateProperty-Eigenschaft ausgelöstes Ereignis	Nie	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Beispiel für den Pane-Steuerelementtyp

Die folgende Abbildung zeigt ein Steuerelement, das den Pane-Steuerelementtyp implementiert.

UI Automation-Struktur - Steuerelementansicht	UI Automation-Struktur - Inhaltsansicht
Pane Struktur (Bildlaufmuster) TreeItem Pane Bearbeiten (Bildlaufmuster)	Pane Struktur (Bildlaufmuster) TreeItem ...Bereich Edit (Bildlaufmuster)

Siehe auch

Referenz

Pane

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung