Benutzeroberflächenautomatisierungs-Unterstützung für den Pane-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 Steuerelementtyp „Pane“. Bei der Benutzeroberflächenautomatisierung stellt ein Steuerelementtyp eine Reihe von Bedingungen dar, die ein Steuerelement erfüllen muss, um die ControlTypeProperty 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 Pane-Steuerelementtyp dient zur Darstellung eines Objekts innerhalb eines Frames oder Dokumentfensters. Benutzer können zwischen Pane-Steuerelementen und dem Inhalt des aktuellen Bereichs, aber nicht zwischen Elementen in unterschiedlichen Bereichen navigieren. Daher stellen Pane-Steuerelemente eine Gruppierungsebene unterhalb von Fenstern oder Dokumenten dar, jedoch oberhalb einzelner Steuerelemente. Der Benutzer kann je nach Kontext durch Drücken von TAB, F6 oder STRG+TAB zwischen den Bereichen navigieren. Für den Pane-Steuerelementtyp ist keine bestimmte Tastaturnavigation erforderlich.
In den folgenden Abschnitten werden die erforderliche Struktur sowie Eigenschaften, Steuerelementmuster und Ereignisse der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Pane“ definiert. Die Anforderungen der Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
Die folgende Tabelle zeigt die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Bereichssteuerelemente und beschreibt die möglichen Inhalte der Ansichten. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Bereich | Bereich |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für Bereichssteuerelemente besonders relevant sind. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung 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. |
| 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 immer ein eindeutiger, präziser und aussagekräftiger Titel sein. |
| ClickablePointProperty | Siehe Hinweise. | Diese Eigenschaft macht einen durch Klicken aktivierbaren Punkt des Bereichssteuerelements verfügbar, durch den der Bereich den Fokus erhält, wenn auf den Punkt geklickt wird. |
| LabeledByProperty | Siehe Hinweise. | Bereichssteuerelemente haben in der Regel keine statische Bezeichnung. Ist eine statische Beschriftung vorhanden, muss sie über diese Eigenschaft verfügbar gemacht werden. |
| ControlTypeProperty | Bereich | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Bereich“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „Pane“. |
| IsContentElementProperty | True | Bereichssteuerelemente sind in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung immer enthalten. |
| IsControlElementProperty | True | Bereichssteuerelemente sind in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung immer enthalten. |
| HelpTextProperty | "" | Der Hilfetext für Bereichssteuerelemente sollte den Zweck des Frames und seine Beziehung zu anderen Frames erklären. Eine Beschreibung ist erforderlich, wenn Zweck und Beziehung von Frames sich nicht eindeutig durch den Wert der NamePropertyergeben. " |
| AccessKeyProperty | Siehe Hinweise. | Wenn der Bereich den Fokus durch eine bestimmte Tastenkombination erhält, müssen diese Informationen über diese Eigenschaft verfügbar gemacht werden. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Pane-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 das Steuerelement verschoben, vergrößert, verkleinert oder auf dem Bildschirm gedreht werden kann. |
| IWindowProvider | Nie | Wenn Sie dieses Steuerelementmuster implementieren müssen, sollte das Steuerelement auf dem Window -Steuerelementtyp basieren. |
| IDockProvider | Depends (Abhängig) | Implementieren Sie dieses Steuerelementmuster, wenn die Größe des Bereichssteuerelements angedockt werden kann. |
| IScrollProvider | Depends (Abhängig) | Implementieren Sie dieses Steuerelementmuster, wenn das Bereichssteuerelement gescrollt werden kann. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Pane-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Unterstützung/Wert | Hinweise |
|---|---|---|
| WindowClosedEvent | Nie | Keine |
| WindowOpenedEvent | Nie | Keine |
| AsyncContentLoadedEvent | Erforderlich | 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 |
| Durch geänderteHorizontallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteWindowVisualStateProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |
Beispiel für Pane-Steuerelementtyp
Das folgende Bild zeigt ein Pane-Steuerelement, für das der Pane-Steuerelementtyp implementiert ist.
| Struktur der Benutzeroberflächenautomatisierung – Steuerelementansicht | Struktur der Benutzeroberflächenautomatisierung – Inhaltsansicht |
|---|---|
|
– Bereich – Struktur (Scrollmuster) – TreeItem – ...Bereich – Bearbeiten – (Scrollmuster) |