Scrollleiste (MSAA UI-Elementreferenz)

Hinweis

In diesem Thema werden Scrollleistenobjekte für die MSAA UI-Elementreferenz beschrieben. Das Erstellen von Scrollleistenobjekten in verschiedenen Benutzeroberflächenframeworks wird 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, in der bzw. dem informationen in einem verknüpften Fenster oder Listenfeld angezeigt werden sollen. Der Name der Fensterklasse für eine Bildlaufleiste lautet "SCROLLBAR".

Der Inhalt der IAccessible-Eigenschaften hängt davon ab, ob die Scrollleiste vertikal oder horizontal ist und von welchem der folgenden Teile der Scrollleiste vom Client abgefragt wird:

  • Die Bildlaufleiste selbst
  • Schaltfläche "Pfeil nach oben" oder "Nach rechts"
  • Schaltfläche "Unten" oder "Pfeil nach links"
  • Das Bildlauffeld ( Thumb)
  • Die Region nach oben oder rechts der Seite
  • Die Nach-unten-Seite oder der linke Bereich der Seite

IAccessible-Methoden

Eine Bildlaufleiste unterstützt die folgenden IAccessible-Methoden:

  • accDoDefaultAction: Das Scrollleistenobjekt selbst und der Bildlauffinger unterstützen die accDoDefaultAction-Methode nicht.

    Für die anderen Teile der Bildlaufleiste auf einer vertikalen Schiebeleiste ruft accDoDefaultAction PostMessage auf, wobei die _ WM-VSCROLL-Nachricht mit wParam auf die folgenden Werte festgelegt ist.

    Schaltfläche/Region Vaule
    Schaltfläche "Pfeil oben" SB _ LINEUP
    Schaltfläche "Pfeil unten" SB _ LINEDOWN
    Vorherige Seite Region SB _ PAGEUP
    Nächste Seite Region SB _ PAGEDOWN

    Für die anderen Bildlaufleistenteile auf einer horizontalen Scrollleiste ruft accDoDefaultAction PostMessage auf, wobei die WM _ HSCROLL-Nachricht mit wParam auf die folgenden Werte festgelegt ist.

    Schaltfläche/Region Wert
    Schaltfläche "Pfeil nach links" SB _ LINELEFT
    Schaltfläche mit Pfeil nach rechts SB _ LINERIGHT
    Linker Bereich der Seite SB _ PAGELEFT
    Rechte Region der Seite SB _ PAGERIGHT
  • accHitTest

  • accLocation

  • accNavigate

IAccessible-Eigenschaften

Eine Bildlaufleiste unterstützt die folgenden IAccessible-Eigenschaften:

  • get _ accChildCount– Die ChildCount-Eigenschaft für das Scrollleistenobjekt ist fünf. Für die anderen Bildlaufleistenteile ist die ChildCount-Eigenschaft 0 (null).

  • get _ accDefaultAction– Das Scrollleistenobjekt 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 Bildlauffingerabdrucks lautet "Press".

  • get _ accDescription– Die Description-Eigenschaft hängt von dem Teil der abgefragten Scrollleiste ab.

    Die Teile einer vertikalen Bildlaufleiste weisen die folgenden Beschreibungen auf.

    Teil BESCHREIBUNG
    Scrollleiste selbst "Wird verwendet, um den vertikalen Anzeigebereich zu ändern"
    Schaltfläche "Pfeil 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."
    Vorherige Seite Region "Verschiebt die vertikale Position um einige Zeilen nach oben"
    Nächste Seite Region "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
    Scrollleiste selbst "Wird verwendet, um den horizontalen Anzeigebereich zu ändern"
    Schaltfläche "Pfeil nach links" "Verschiebt die horizontale Position nach links um eine Spalte"
    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 Bereich der Seite "Verschiebt die horizontale Position nach links um einige Spalten".
    Rechte Region der Seite "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 von dem Teil der abgefragten Scrollleiste ab.

    Die Teile einer vertikalen Bildlaufleiste haben die folgenden Namen.

    Teil Name
    Bildlaufleistenfenster "Vertikal"
    Schaltfläche "Pfeil oben" "Line up"
    Schaltfläche "Pfeil unten" "Line down" (Nach unten)
    Bildlauffinger "Position"
    Vorherige Seite Region "Vorherige Seite"
    Nächste Seite Region "Nächste Seite"

    Die Teile einer horizontalen Bildlaufleiste haben die folgenden Namen.

    Teil Name
    Scrollleistenfenster "Horizontal"
    Nach-links-Taste "Spalte links"
    Schaltfläche mit Pfeil nach rechts "Spaltenrecht"
    Bildlauffinger "Position"
    Seitenrechter Bereich "Seitenrecht"
    Linker Seitenbereich "Seite links"
  • get _ accParent– Die Übergeordnete Eigenschaft der Pfeilschaltflächen, des Bildlauffingers und der schattierte Bereich auf beiden Seiten des Strichs ist das Scrollleistenfenster. Die Parent-Eigenschaft des Scrollleistenfensters ist ein Fenster (ROLE SYSTEM WINDOW), das das Steuerelement umschließt und über die gleiche Name-Eigenschaft und den gleichen _ _ Fensterklassennamen verfügt.

  • get _ accRole :Die Role-Eigenschaft hängt vom Abgefragten Teil der Scrollleiste ab. Die Teile einer Scrollleiste haben die folgenden Rollen.

    Teil Rolle
    Scrollleiste selbst _ _ ROLLENSYSTEM-BILDLAUFLEISTE
    Pfeilschaltflächen nach oben, unten, links und rechts _ _ ROLLENSYSTEM-PUSHBUTTON
    Bildlauffinger _ _ ROLLENSYSTEMINDIKATOR
    Vorherige Seite, Nach-unten-, Seiten-links- und Seiten-rechts-Regionen _ _ ROLLENSYSTEM-PUSHBUTTON
  • get _ accState: Die State-Eigenschaft jeder Scrollleistenkomponente enthält eine Kombination der folgenden Werte.

    State Wert
    ZUSTANDSSYSTEM _ _ UNSICHTBAR Für die Bildlaufleiste selbst gibt dies an, dass die angegebene vertikale oder horizontale Scrollleiste nicht vorhanden ist. Für die Bereiche "Nach oben" oder "Nach unten" gibt dies an, dass der Daumen so positioniert ist, dass der Bereich nicht vorhanden ist.
    _ _ STATUSSYSTEM-OFFSCREEN Für die Bildlaufleiste selbst gibt dies an, dass das Fenster so dimensioniert ist, dass die angegebene vertikale oder horizontale Scrollleiste derzeit nicht angezeigt wird.
    ZUSTANDSSYSTEM _ _ GEDRÜCKT Die Pfeilschaltfläche oder der Seitenbereich wird gedrückt.
    ZUSTANDSSYSTEM _ _ NICHT VERFÜGBAR Die Komponente ist deaktiviert.
  • get _ accValue –Die Value-Eigenschaft für das Scrollleistenfenster gibt die Position der Scrollleiste an und ist eine Zeichenfolge, die eine ganze Zahl von "0" bis "100" enthält.

IAccessible-Schnittstelle