ScrollBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den ScrollBar- Steuerelementtyp.
Bildlaufleistensteuerelemente ermöglichen benutzern das Scrollen von Inhalten innerhalb eines Fenster- oder Elementcontainers. Das Steuerelement besteht aus einer Reihe von Schaltflächen und einem Daumensteuerelement.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ScrollBar- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Bildlaufleistensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Bildlaufleistensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
Steuerelementansicht | Inhaltsansicht |
---|---|
|
Nicht zutreffend. (Das Bildlaufleisten-Steuerelement hat keinen Inhalt.) |
Das Bildlaufleisten-Steuerelement 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 auf jedes Element festlegen, um sie für automatisierte Testtools auffindbar zu machen.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Bildlaufleistensteuerelemente relevant ist. Beachten Sie, dass ein Bildlaufleisten-Steuerelement nie Inhalt hat; seine Funktionalität wird über das Scroll- Steuerelementmuster verfügbar gemacht, das für den Container unterstützt wird, der gescrollt wird.
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 | NaN | Das Bildlaufleisten-Steuerelement verfügt nicht über klickbare Punkte. |
UIA_ControlTypePropertyId | ScrollBar- | Dieser Wert ist für alle Frameworks identisch. Bildlaufleisten, die als Schieberegler funktionieren, müssen den Schieberegler Steuerelementtyp verwenden. |
UIA_IsContentElementPropertyId | FALSCH | 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 IUIAutomationElement::CurrentControlType (oder CachedControlType) -Eigenschaft zurückgeben. |
UIA_IsControlElementPropertyId | STIMMT | Das Bildlaufleisten-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. Ein Bildlaufleisten-Steuerelement nimmt selten den Fokus, aber wenn dies der Fall ist, sollte der Fokus auf dem Bildlaufleisten-Steuerelement selbst und nicht auf den untergeordneten Schaltflächen oder dem Daumen verbleiben. 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 NACH-OBEN- und BILD-NACH-UNTEN-TASTE auszuführen. |
UIA_LabeledByPropertyId | NULL | Bildlaufleisten verfügen nicht über Beschriftungen. |
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 Steuerelement für die Bildlaufleiste verfügt nicht über Inhaltselemente, und die eigenschaft UIA_NamePropertyId muss nicht festgelegt werden. |
UIA_OrientationPropertyId | Siehe Hinweise. | Das Bildlaufleisten-Steuerelement muss seine horizontale oder vertikale Ausrichtung immer verfügbar machen. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Bildlaufleistensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
Anmerkung
Wenn eine Bildlaufleiste nur als Steuerelement für die Mausmanipulation verwendet wird, unterstützt sie keine Steuerelementmuster. Wenn es in einer Anwendung als Schieberegler-Steuerelement verwendet wird, muss er dem Schieberegler Steuerelementtyps übergeben werden.
Steuerelementmuster | Unterstützen | Notizen |
---|---|---|
IRangeValueProvider- | Hängt | Das RangeValue- Steuerelementmusters muss nur unterstützt werden, wenn das Steuerelementmuster Bildlauf für den Container mit der Bildlaufleiste nicht unterstützt wird. |
IScrollProvider- | Nie | Das Bildlauf- Steuerelementmusters wird nie direkt auf der Bildlaufleiste unterstützt. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die für die Unterstützung von Bildlaufleistensteuerelementen erforderlich sind. 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_StructureChangedEventId | |
UIA_RangeValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das RangeValue- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung