Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieses Thema enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den ScrollBar-Steuerelementtyp. Bei der Benutzeroberflächenautomatisierung ist ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Baumstruktur der UI Automation, Eigenschaftswerte der UI Automation und Steuermuster.
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 Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms.
Erforderliche UI-Automatisierungsbaumstruktur
Die folgende Tabelle zeigt die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Bildlaufleistensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungs-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Scrollleiste - Schaltfläche (2 oder 4) - Daumen (0 oder1) |
Nicht zutreffend. Das Bildlaufleisten-Steuerelement enthält keinen Inhalt. |
Das Bildlaufleisten-Steuerelement umfasst immer drei bis fünf untergeordnete Elemente. Da die Unterstruktur über mehrere Schaltflächensteuerelemente verfügt, müssen Sie für jedes Element einen bestimmten AutomationIdProperty Wert festlegen, damit sie für Testautomatisierungstools auffindbar sind.
Erforderliche Benutzeroberflächenautomatisierungs-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 Scrollleisten-Steuerelement nie Inhalt hat; seine Funktionalität wird über das Scroll-Steuerungsmuster verfügbar gemacht, das im Container unterstützt wird, der gescrollt wird.
Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Null |
Das Steuerelement für die Bildlaufleiste enthält keine Inhaltselemente, und es ist nicht erforderlich, NameProperty festzulegen. |
| ClickablePointProperty | Keine Zahl. | Das Bildlaufleisten-Steuerelement verfügt nicht über klickbare Punkte. |
| LabeledByProperty | Null |
Bildlaufleisten verfügen nicht über Beschriftungen. |
| ControlTypeProperty | Scrollleiste | Dieser Wert ist für alle Frameworks identisch. Von Bildlaufleisten, die wie Schieberegler funktionieren, muss der Slider-Steuerelementtyp verwendet werden. |
| LocalizedControlTypeProperty | „Bildlaufleiste“ | Lokalisierte Zeichenfolge, die dem Steuerelementtyp "Button" entspricht. |
| IsContentElementProperty | Falsch | Das Bildlaufleisten-Steuerelement ist nie ein Inhaltselement. Wenn es sich bei der Bildlaufleiste um ein eigenständiges Steuerelement handelt, muss es dem Slider-Steuerelementtyp entsprechen und ControlType.Slider für die ControlType -Eigenschaft zurückgeben. |
| IsControlElementProperty | Richtig | Die Bildlaufleiste muss immer ein Steuerelement sein. |
| OrientationProperty | Richtig | Das Bildlaufleisten-Steuerelement muss seine horizontale oder vertikale Ausrichtung immer verfügbar machen. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von ScrollBar-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung. Beachten Sie, dass Steuerelementmuster nicht unterstützt werden, wenn eine Bildlaufleiste nur über eine Maus als Steuerelement verwendet wird. Wenn es in einer Anwendung als Schieberegler verwendet wird, muss ihm der Steuerelementtyp „Schieberegler“ zugewiesen werden.
| Steuerelementmuster | Unterstützung | Hinweise |
|---|---|---|
| IScrollProvider | Nie | Das Scroll-Steuerelementmuster wird auf der Bildlaufleiste nie direkt unterstützt. |
| IRangeValueProvider | Hängt | Diese Funktionalität muss nur unterstützt werden, wenn das Scroll-Steuerelementmuster von dem Container, der die Bildlaufleiste enthält, nicht unterstützt wird. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Bildlaufleistensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Support/Wert | Hinweise |
|---|---|---|
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die HorizontallyScrollableProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die HorizontalScrollPercentProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die HorizontalViewSizeProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die VerticalScrollPercentProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die VerticallyScrollableProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die VerticalViewSizeProperty-Eigenschaft geändertes Ereignis. | Nie | Nichts |
| Durch die ValueProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |