Freigeben über

Schieberegler-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Slider- Steuerelementtyp.

Ein Schieberegler-Steuerelement 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 erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Slider Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Schiebereglersteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Schiebereglersteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Schieberegler
    • Schaltfläche (2 oder 4)
    • Daumen (1)
    • Listenelement (0 oder mehr)
  • Schieberegler
    • Listenelement (0 oder mehr)

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Schiebereglersteuerelemente 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 Großteil der Schieberegler-Steuerelemente muss den UIA_E_NOCLICKABLEPOINT Fehler zurückgeben, da das gesamte umgebende Rechteck des Schieberegler-Steuerelements von untergeordneten Steuerelementen belegt wird.
UIA_ControlTypePropertyId Schieberegler- Dieser Wert ist für alle Frameworks identisch.
UIA_IsContentElementPropertyId STIMMT Das Schieberegler-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Schieberegler-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 Schieberegler-Steuerelements sollten niemals den Fokus übernehmen. Der Fokus sollte immer auf dem Schieberegler-Steuerelement selbst verbleiben.
UIA_LabeledByPropertyId Siehe Hinweise. Wenn dem Steuerelement eine statische Textbeschriftung zugeordnet ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Textsteuerelement ein Unterkomponente eines anderen Steuerelements ist, verfügt es nicht über einen LabeledBy-Eigenschaftssatz.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Slider- Steuerelementtyp entspricht. Der Standardwert ist "Schieberegler" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Schieberegler-Steuerelements wird in der Regel aus einer statischen Textbezeichnung generiert. Wenn keine statische Textbeschriftung vorhanden ist, muss dem Anwendungsentwickler ein Eigenschaftswert für Name zugewiesen werden.

 

Erforderliche Steuerelementmuster

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

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Schiebereglersteuerelemente 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 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.

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung