Freigeben über

Schieberegler-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des Schieberegler-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Ein Schiebereglersteuerelement ist ein zusammengesetztes Steuerelement mit Schaltflächen, mit denen ein Benutzer einen numerischen Bereich festlegen oder aus einer Gruppe von Elementen auswählen kann.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Schieberegler-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Schiebereglersteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert ist.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Schiebereglersteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Schieberegler
    • Schaltfläche (2 oder 4)
    • Daumen (1)
    • Listenelement (beliebige Anzahl)
  • Schieberegler
    • Listenelement (beliebige Anzahl)

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für Schiebereglersteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.

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. Die meisten Schiebereglersteuerelemente müssen den UIA_E_NOCLICKABLEPOINT Fehler zurückgeben, da das gesamte begrenzungsfähige Rechteck des Schiebereglersteuerelements von untergeordneten Steuerelementen belegt ist.
UIA_ControlTypePropertyId Schieberegler Dieser Wert ist für alle Frameworks gleich.
UIA_IsContentElementPropertyId TRUE Das Schiebereglersteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Schiebereglersteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Die untergeordneten Elemente (Schaltflächen und Daumen) eines Schiebereglersteuerelements sollten niemals den Fokus einnehmen. Der Fokus sollte immer auf dem Schieberegler-Steuerelement selbst bleiben.
UIA_LabeledByPropertyId Siehe Hinweise. Wenn dem Steuerelement eine statische Textbezeichnung zugeordnet ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Textsteuerelement eine Unterkomponente eines anderen Steuerelements ist, ist keine LabeledBy-Eigenschaft festgelegt.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Schieberegler-Steuerelementtyp entspricht. Der Standardwert ist "Schieberegler" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Schiebereglersteuerelements wird in der Regel aus einer statischen Textbezeichnung generiert. Wenn keine statische Textbeschriftung vorhanden ist, muss vom Anwendungsentwickler ein Eigenschaftswert für Name zugewiesen werden.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Schieberegler-Steuerelementen 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) Ein Schieberegler sollte das RangeValue-Steuerelementmuster unterstützen, wenn der Inhalt auf einen Wert innerhalb eines numerischen Bereichs festgelegt werden kann.
ISelectionProvider Depends (Abhängig) Ein Schieberegler sollte das Auswahl-Steuerelementmuster unterstützen, wenn der Inhalt einen Wert unter einem diskreten Satz von Optionen darstellt. Wenn das Selection-Steuerelementmuster unterstützt wird, muss die entsprechende Auswahl als ein oder mehrere untergeordnete Listenelemente des Schiebereglers verfügbar gemacht werden.
IValueProvider Depends (Abhängig) Ein Schieberegler sollte das Wert-Steuerelementmuster unterstützen, wenn der Inhalt einen Wert unter einem diskreten Satz von Optionen darstellt.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Schiebereglersteuerelemente unterstützen 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 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