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

IAccessible-Methoden

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

     

  • accHitTest

  • accLocation

  • accNavigate

IAccessible-Eigenschaften

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_accHelp

  • get_accHelpTopic

  • 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.

IAccessible-Schnittstelle