Drehfeld-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Spinner- Steuerelementtyp.
Drehfeldsteuerelemente werden verwendet, um aus einer Domäne von Elementen oder einem Zahlenbereich auszuwählen.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Spinner- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Drehfeldsteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Drehfeldsteuerelemente bezieht, wenn sie die RangeValue- und Selection Steuerelementmuster unterstützen und beschreiben, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
RangeValue-Steuerelementmuster
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Auswahl-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 ScrollAmount_SmallIncrement oder ScrollAmount_SmallDecrement Wert der AutomationId Eigenschaft entsprechend zu. Bei einigen Implementierungen kann das zugeordnete Bearbeitungssteuerelement ein Peer des Drehfeld-Steuerelements sein.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungs-Eigenschaften aufgeführt, deren Wert oder Definition besonders für Drehfeldsteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Der klickbare Punkt des Drehfelds gibt den Fokus auf den Bearbeitungsbereich des Steuerelements. |
| UIA_ControlTypePropertyId | Spinner- | Dieser Wert ist für alle Frameworks identisch. |
| UIA_IsContentElementPropertyId | STIMMT | Das Drehfeld-Steuerelement muss immer Inhalt sein. |
| UIA_IsControlElementPropertyId | STIMMT | Das Drehfeld-Steuerelement muss immer ein Steuerelement sein. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Ein Drehfeld-Steuerelement nimmt selten den Fokus, aber wenn dies der Fall ist, sollte der Fokus auf dem Drehfeld-Steuerelement selbst und nicht auf den untergeordneten Schaltflächen verbleiben. Der Benutzer sollte in der Lage sein, alle Bildlaufaktionen mithilfe der NACH-OBEN- und NACH-UNTEN-TASTE auszuführen. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Drehfeldsteuerelemente weisen eine statische Textbezeichnung auf. |
| 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 Drehfeld-Steuerelement ruft in der Regel seinen Namen aus einer statischen Textbezeichnung ab. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Drehfeldsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Control Pattern/Pattern-Eigenschaft | Support/Wert | Notizen |
|---|---|---|
| IRangeValueProvider- | Hängt | Drehfeldsteuerelemente, die einen numerischen Bereich umfassen, können das RangeValue- Steuerelementmuster unterstützen. |
| ISelectionProvider- | Hängt | Drehfeldsteuerelemente, die eine Liste der auszuwählenden Elemente enthalten, müssen das Auswahlmuster Steuerelements unterstützen. |
| CanSelectMultiple- | FALSCH | Drehfeldsteuerelemente sind immer einzelne Auswahlcontainer. |
| IValueProvider- | Hängt | Drehfeldsteuerelemente, die einen Decretesatz von Optionen oder Zahlen umfassen, können das Wert- Steuerelementmuster unterstützen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die Spinnersteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_RangeValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das RangeValue- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_Selection_InvalidatedEventId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Selection Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung