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

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
  • 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 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.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. 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 _ Ereignis _ zur Änderung der InvalidatedEventId-Eigenschaft. Wenn das Steuerelement das Selection-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ StructureChangedEventId
UIA _ Durch die 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