Freigeben über

Typ des Spinnersteuerelements

  • Artikel

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

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
  • Spinner
    • Bearbeitung (0 oder 1)
    • Schaltfläche (2)
  • Spinner

 

Selection-Steuerelementmuster

Steuerelementansicht Inhaltsansicht
  • Spinner
    • Bearbeitung (0 oder 1)
    • Schaltfläche (2)
    • Listenelement (beliebige Anzahl)
  • Spinner
    • ListItem (beliebige Anzahl)

 

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.

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung