ScrollBar-Steuerelementtyp

  • Artikel

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

Mit ScrollBar-Steuerelementen können Sie einen Bildlauf für den Inhalt eines Fenster- oder Elementcontainers ausführen. Das Steuerelement besteht aus einer Reihe von Schaltflächen und einem Daumensteuerelement.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ScrollBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Bildlaufleistensteuerelemente, bei denen das Benutzeroberflächenframework bzw. 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 Scrollleistensteuerelemente 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
  • ScrollBar
    • Schaltfläche (0, 2 oder 4)
    • Daumen (0 oder 1)
 Nicht zutreffend (Das Bildlaufleistensteuerelement hat keinen Inhalt.)

 

Das Bildlaufleistensteuerelement kann null bis fünf untergeordnete Elemente aufweisen. Da die Unterstruktur über mehrere Schaltflächensteuerelemente verfügt, muss das Element einen bestimmten UIA_AutomationIdPropertyId Wert für jedes Element festlegen, damit diese für automatisierte Testtools auffindbar sind.

Relevante Eigenschaften

Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für ScrollBar-Steuerelemente besonders relevant sind. Beachten Sie, dass ein Bildlaufleistensteuerelement niemals Inhalte enthält. seine Funktionalität wird über das Scroll-Steuerelementmuster verfügbar gemacht, das für den zu scrollenden Container unterstützt wird.

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 NaN Das Bildlaufleisten-Steuerelement enthält keine durch Klicken aktivierbaren Punkte.
UIA_ControlTypePropertyId ScrollBar Dieser Wert ist für alle Frameworks gleich. Bildlaufleisten, die als Schieberegler fungieren, müssen den Schieberegler-Steuerelementtyp verwenden.
UIA_IsContentElementPropertyId FALSE Das Bildlaufleisten-Steuerelement ist nie ein Inhaltselement. Wenn die Bildlaufleiste ein eigenständiges Steuerelement ist, muss sie den Slider-Steuerelementtyp erfüllen und UIA_SliderControlTypeId für die Eigenschaft IUIAutomationElement::CurrentControlType (oder CachedControlType) zurückgeben.
UIA_IsControlElementPropertyId TRUE Das Bildlaufleistensteuerelement 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. Ein Bildlaufleistensteuerelement nimmt selten den Fokus ein, aber wenn dies der Fall ist, sollte der Fokus auf dem Bildlaufleistensteuerelement selbst bleiben, nicht auf den untergeordneten Schaltflächen oder dem Daumen. Der Benutzer sollte in der Lage sein, alle Bildlaufaktionen mithilfe der NACH-OBEN- und NACH-UNTEN-TASTE (oder NACH-RECHTS- und NACH-LINKS-TASTE) oder der SEITEN-NACH-OBEN- und SEITEN-NACH-UNTEN-TASTE auszuführen.
UIA_LabeledByPropertyId NULL Bildlaufleisten weisen keine Bezeichnungen auf.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp ScrollBar entspricht. Der Standardwert ist "Scrollleiste" für en-US oder Englisch (USA).
UIA_NamePropertyId NULL Das Bildlaufleistensteuerelement verfügt nicht über Inhaltselemente, und die UIA_NamePropertyId-Eigenschaft muss nicht festgelegt werden.
UIA_OrientationPropertyId Siehe Hinweise. Die horizontale oder vertikale Ausrichtung muss vom Bildlaufleisten-Steuerelement immer verfügbar gemacht werden.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Scrollleistensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Hinweis

Wenn eine Bildlaufleiste nur als Steuerelement für Mausmanipulation verwendet wird, unterstützt sie keine Steuerelementmuster. Wenn es als Schiebereglersteuerelement in einer Anwendung verwendet wird, muss es den Schieberegler-Steuerelementtyp erhalten.

 

Steuerelementmuster Support Hinweise
IRangeValueProvider Depends (Abhängig) Das RangeValue-Steuerelementmuster muss nur unterstützt werden, wenn das Scroll-Steuerelementmuster für den Container mit der Bildlaufleiste nicht unterstützt wird.
IScrollProvider Nie Das Scroll-Steuerelementmuster wird nie direkt auf der Bildlaufleiste unterstützt.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Scrollleistensteuerelemente 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_StructureChangedEventId
UIA_RangeValueValuePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das RangeValue-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung