Typ des Spinnersteuerelements
Dieses Thema enthält Informationen zur Unterstützung des Spinner-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
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 Typ des Spinner-Steuerelements definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Spinnersteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur der Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur der Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Drehersteuerelemente bezieht, wenn diese die RangeValue- und Selection-Steuerelementmuster unterstützen, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
RangeValue-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Selection-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Um sicherzustellen, dass die beiden Schaltflächen in der Steuerelementansichtsunterstruktur durch automatisierte Testtools unterschieden werden können, weisen Sie der AutomationId-Eigenschaft den ScrollAmount_SmallIncrement oder ScrollAmount_SmallDecrement Wert entsprechend zu. Bei einigen Implementierungen kann das zugeordnete Bearbeitungssteuerelement ein Peer des Spinnersteuerelements sein.
Relevante Eigenschaften
Die folgende Tabelle listet die Benutzeroberflächenautomatisierungs-Eigenschaften auf, deren Werte oder Definitionen für Spinner-Steuerelemente besonders relevant sind. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht 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 Spinner-Steuerelement nimmt selten den Fokus ein, aber wenn dies der Fall ist, sollte der Fokus auf dem Drehersteuerelement selbst verbleiben, nicht auf den untergeordneten Schaltflächen. Der Benutzer sollte in der Lage sein, alle Bildlaufaktionen 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 Typ des Spinner-Steuerelements 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 | Hinweise |
|---|---|---|
| IRangeValueProvider | Depends (Abhängig) | Drehersteuerelemente, die sich über einen numerischen Bereich erstrecken, können das RangeValue-Steuerelementmuster unterstützen. |
| ISelectionProvider | Depends (Abhängig) | Spinnersteuerelemente, die über eine Liste von Elementen verfügen, die ausgewählt werden sollen, müssen das Auswahl-Steuerelementmuster unterstützen. |
| CanSelectMultiple | FALSE | Spinner-Steuerelemente sind immer Einfachauswahlcontainer. |
| IValueProvider | Depends (Abhängig) | Spinnersteuerelemente, die einen Decrete-Satz von Optionen oder Zahlen umfassen, können das Wert-Steuerelementmuster unterstützen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Von Spinnersteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_RangeValueValuePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das RangeValue-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_Selection_InvalidatedEventId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Selection-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Zugehörige Themen