Benutzeroberflächenautomatisierungs-Unterstützung für den Spinner-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.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Spinner“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Spinner-Steuerelemente werden dazu verwendet, um aus einem Bereich von Elementen oder Zahlen auszuwählen.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Spinner“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Spinner-Steuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgende Tabelle wird die Steuerelementansicht und Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung dargestellt, die für Spinner-Steuerelemente gelten, wenn sie die „Range Value“-, „Value“- und „Selection“-Steuerelementmuster unterstützen und beschreiben, was in der jeweiligen Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
„Range Value“- oder „Value“-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Spinner – Bearbeitung (0 oder 1) – Schaltfläche (2) |
Spinner |
Selection-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Spinner – Bearbeitung (0 oder 1) – Schaltfläche (2) – Listenelement (0 oder mehr) |
Spinner – ListItem (0 oder mehr) |
Um sicherzustellen, dass die beiden Schaltflächen in der Unterstruktur der Steuerelementansicht von automatisierten Testtools unterschieden werden können, weisen Sie entsprechend SmallIncrement oder SmallDecrement AutomationId zu. Bei einigen Implementierungen ist das zugeordnete Edit-Steuerelement möglicherweise ein Peer des Spinner-Steuerelements.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle listet die Benutzeroberflächenautomatisierungs-Eigenschaften auf, deren Werte oder Definitionen für Spinner-Steuerelemente 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. |
| ClickablePointProperty | Siehe Hinweise. | Der durch Klicken aktivierbare Punkt des Spinner-Steuerelements übergibt den Fokus an den Bearbeitungsbereich des Steuerelements. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Siehe Hinweise. | Das Spinner-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab. |
| LabeledByProperty | Siehe Hinweise. | Spinner-Steuerelemente verfügen über eine statische Textbezeichnung. |
| ControlTypeProperty | Spinner | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Drehfeld“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „Spinner“. |
| IsContentElementProperty | True | Das Spinner-Steuerelement muss immer ein Inhaltselement sein. |
| IsControlElementProperty | True | Das Spinner-Steuerelement muss immer ein Steuerelement sein. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und -Eigenschaften
In der folgenden Tabelle sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von Spinner-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Hinweise |
|---|---|---|
| ISelectionProvider | Depends (Abhängig) | Spinner-Steuerelemente mit einer zur Auswahl stehenden Liste von Elementen müssen dieses Muster unterstützen. |
| CanSelectMultiple | Falsch | Spinner-Steuerelemente sind immer Einfachauswahlcontainer. |
| IRangeValueProvider | Depends (Abhängig) | Spinner-Steuerelemente, die einen numerischen Bereich umfassen, können dieses Muster unterstützen. |
| IValueProvider | Depends (Abhängig) | Spinner-Steuerelemente, die einen einzelnen Satz von Optionen oder Zahlen umfassen, können dieses Muster unterstützen. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Spinner-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Hinweise |
|---|---|---|
| InvalidatedEvent | 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 |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |