Spinner-Steuerelementtyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Spinner-Steuerelementtyp.
Spinner-Steuerelemente werden dazu verwendet, um aus einem Bereich von Elementen oder Zahlen auszuwählen.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Spinner-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Spinnersteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die spinner-Steuerelemente betreffen, wenn sie die RangeValue- und Selection-Steuerelementmuster unterstützen, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
RangeValue-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Selection-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Um sicherzustellen, dass die beiden Schaltflächen in der Unterstruktur der Steuerelementansicht durch automatisierte Testtools unterschieden werden können, weisen Sie den Wert ScrollAmount _ SmallIncrement oder ScrollAmount _ SmallDecrement der AutomationId-Eigenschaft entsprechend zu. Bei einigen Implementierungen kann das zugeordnete Bearbeitungssteuerelement ein Peer des Spinnersteuerelements sein.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für Spinnersteuerelemente besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Der durch Klicken aktivierbare Punkt des Spinner-Steuerelements übergibt den Fokus an den Bearbeitungsbereich des Steuerelements. |
| UIA _ ControlTypePropertyId | Spinner | Dieser Wert ist für alle Frameworks gleich. |
| UIA _ IsContentElementPropertyId | TRUE | Das Spinner-Steuerelement muss immer ein Inhaltselement sein. |
| UIA _ IsControlElementPropertyId | TRUE | Das Spinnersteuerelement muss immer ein -Steuerelement sein. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Ein Spinnersteuerelement nimmt den Fokus nur selten in den Fokus, aber wenn es dies tut, sollte der Fokus auf dem Drehfeldsteuerelement selbst und nicht auf den untergeordneten Schaltflächen bleiben. Der Benutzer sollte in der Lage sein, alle Scrollaktionen mithilfe der NACH-OBEN- und NACH-UNTEN-TASTE auszuführen. |
| UIA _ LabeledByPropertyId | Siehe Hinweise. | Spinner-Steuerelemente verfügen über eine statische Textbezeichnung. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Spinner-Steuerelementtyp entspricht. Der Standardwert ist "spinner" für en-US oder Englisch (USA). |
| _UIA-NamePropertyId | Siehe Hinweise. | Das Spinner-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Spinnersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| IRangeValueProvider | Depends (Abhängig) | Spinner-Steuerelemente, die einen numerischen Bereich umfassen, können das RangeValue-Steuerelementmuster unterstützen. |
| ISelectionProvider | Depends (Abhängig) | Spinner-Steuerelemente, die über eine Liste von elementen verfügen, die ausgewählt werden sollen, müssen das Selection-Steuerelementmuster unterstützen. |
| CanSelectMultiple | FALSE | Spinner-Steuerelemente sind immer Einfachauswahlcontainer. |
| IValueProvider | Depends (Abhängig) | Spinner-Steuerelemente, die sich über eine Reihe von Optionen oder Zahlen erstrecken, können das Value-Steuerelementmuster unterstützen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die spinner-Steuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.