Bildlaufleiste (MSAA UI-Elementreferenz)
Hinweis
In diesem Thema werden Scrollleistenobjekte für die MSAA-Benutzeroberflächenelementreferenz beschrieben. Das Erstellen von Bildlaufleistenobjekten in verschiedenen Benutzeroberflächenframeworks ist hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.
Mithilfe von Bildlaufleisten können Benutzer die Richtung und den Abstand auswählen, um in informationen in einem zugehörigen Fenster oder Listenfeld zu scrollen. Der Name der Fensterklasse für eine Bildlaufleiste lautet "SCROLLBAR".
Der Inhalt der IAccessible-Eigenschaften hängt davon ab, ob die Bildlaufleiste vertikal oder horizontal ist und welche der folgenden Teile der Bildlaufleiste vom Client abgefragt wird:
- Die Bildlaufleiste selbst
- Die Nach-oben- oder Nach-rechts-Taste
- Die Nach-unten- oder Nach-links-Taste
- Das Bildlauffeld (Daumen)
- Der Bereich nach oben oder rechts von der Seite
- Der Seitenab- oder Seitenbereich links
Eine Bildlaufleiste unterstützt die folgenden IAccessible-Methoden :
accDoDefaultAction: Das Bildlaufleistenobjekt selbst und der Bildlauffinger unterstützen die accDoDefaultAction-Methode nicht.
Für die anderen Bildlaufleistenteile auf einer vertikalen Bildlaufleiste ruft accDoDefaultActionPostMessage auf, wobei die WM_VSCROLL Nachricht mit wParam auf die folgenden Werte festgelegt ist.
Schaltfläche/Region Vaule Schaltfläche "Nach oben" SB_LINEUP Schaltfläche "Pfeil unten" SB_LINEDOWN Aufblättern des Bereichs SB_PAGEUP Abblättern des Bereichs SB_PAGEDOWN Für die anderen Bildlaufleistenteile auf einer horizontalen Bildlaufleiste ruft accDoDefaultActionPostMessage auf, wobei die WM_HSCROLL Nachricht mit wParam auf die folgenden Werte festgelegt ist.
Schaltfläche/Region Wert Nach-links-Taste SB_LINELEFT Schaltfläche mit Pfeil nach rechts SB_LINERIGHT Linker Seitenbereich SB_PAGELEFT Seitenbereich rechts SB_PAGERIGHT
Eine Bildlaufleiste unterstützt die folgenden IAccessible-Eigenschaften :
get_accChildCount: Die ChildCount-Eigenschaft für das Bildlaufleistenobjekt ist fünf. Für die anderen Bildlaufleistenteile ist die ChildCount-Eigenschaft null.
get_accDefaultAction: Das Bildlaufleistenobjekt selbst und der Bildlauffinger unterstützen die DefaultAction-Eigenschaft nicht. Die DefaultAction-Eigenschaft für die Pfeilschaltflächen und die schattierten Bereiche auf beiden Seiten des Bildlauffingers lautet "Drücken".
get_accDescription: Die Description-Eigenschaft hängt vom Abgefragten Teil der Bildlaufleiste ab.
Die Teile einer vertikalen Bildlaufleiste weisen die folgenden Beschreibungen auf.
Teil BESCHREIBUNG Bildlaufleiste selbst "Wird verwendet, um den vertikalen Anzeigebereich zu ändern" Schaltfläche "Nach oben" "Verschiebt die vertikale Position um eine Zeile nach oben" Schaltfläche "Pfeil unten" "Verschiebt die vertikale Position um eine Zeile nach unten" Bildlauffinger "Gibt die aktuelle vertikale Position an und kann gezogen werden, um sie direkt zu ändern" Aufblättern des Bereichs "Verschiebt die vertikale Position ein paar Zeilen nach oben" Abblättern des Bereichs "Gibt die aktuelle vertikale Position an und kann gezogen werden, um sie direkt zu ändern" Die Teile einer horizontalen Bildlaufleiste weisen die folgenden Beschreibungen auf.
Teil BESCHREIBUNG Bildlaufleiste selbst "Wird verwendet, um den horizontalen Anzeigebereich zu ändern" Nach-links-Taste "Verschiebt die horizontale Position um eine Spalte nach links" Schaltfläche mit Pfeil nach rechts "Verschiebt die horizontale Position um eine Spalte nach rechts" Bildlauffinger "Gibt die aktuelle horizontale Position an und kann gezogen werden, um sie direkt zu ändern" Linker Seitenbereich "Verschiebt die horizontale Position um ein paar Spalten nach links" Seitenbereich rechts "Gibt die aktuelle vertikale Position an und kann gezogen werden, um sie direkt zu ändern" get_accName: Die Name-Eigenschaft hängt vom Abgefragten Teil der Bildlaufleiste ab.
Die Teile einer vertikalen Bildlaufleiste haben die folgenden Namen.
Teil Name Fenster der Bildlaufleiste "Vertikal" Schaltfläche "Nach oben" "Line up" Schaltfläche "Pfeil unten" "Linie nach unten" Bildlauffinger "Position" Aufblättern des Bereichs "Bild nach oben" Abblättern des Bereichs "Seite nach unten" Die Teile einer horizontalen Bildlaufleiste haben die folgenden Namen.
Teil Name Fenster der Bildlaufleiste "Horizontal" Nach-links-Taste "Spalte links" Schaltfläche mit Pfeil nach rechts "Spalte rechts" Bildlauffinger "Position" Seitenbereich rechts "Seite rechts" Linker Seitenbereich "Seite links" get_accParent– Die Parent-Eigenschaft der Pfeilschaltflächen, des Bildlauffingers und des schattierten Bereichs auf beiden Seiten des Daumens ist das Fenster der Bildlaufleiste. Die Parent-Eigenschaft des Bildlaufleistenfensters ist ein Fenster (ROLE_SYSTEM_WINDOW), das das Steuerelement umgibt und die gleiche Name-Eigenschaft und den gleichen Namen der Fensterklasse aufweist.
get_accRole: Die Role-Eigenschaft hängt vom Abgefragten Teil der Bildlaufleiste ab. Die Teile einer Bildlaufleiste haben die folgenden Rollen.
Teil Rolle Bildlaufleiste selbst ROLE_SYSTEM_SCROLLBAR Pfeiltasten nach oben, unten, links und nach rechts ROLE_SYSTEM_PUSHBUTTON Bildlauffinger ROLE_SYSTEM_INDICATOR Seiten nach oben, Seite nach unten, Seite links und Seite rechts ROLE_SYSTEM_PUSHBUTTON get_accState: Die State-Eigenschaft jeder Bildlaufleistenkomponente enthält eine Kombination der folgenden Werte.
State Wert STATE_SYSTEM_INVISIBLE Für die Bildlaufleiste selbst gibt dies an, dass die angegebene vertikale oder horizontale Bildlaufleiste nicht vorhanden ist. Für den Seitenauf- oder Seitenabbereich gibt dies an, dass der Daumen so positioniert ist, dass der Bereich nicht vorhanden ist. STATE_SYSTEM_OFFSCREEN Für die Bildlaufleiste selbst gibt dies an, dass das Fenster so dimensioniert ist, dass die angegebene vertikale oder horizontale Bildlaufleiste derzeit nicht angezeigt wird. STATE_SYSTEM_PRESSED Die Pfeilschaltfläche oder der Seitenbereich wird gedrückt. STATE_SYSTEM_UNAVAILABLE Die Komponente ist deaktiviert. get_accValue – Die Value-Eigenschaft für das Fenster der Bildlaufleiste gibt die Position der Bildlaufleiste an und ist eine Zeichenfolge, die eine ganze Zahl von "0" bis "100" enthält.