The `GtkScrollbar` widget is a horizontal or vertical scrollbar.


Its position and movement are controlled by the adjustment that is passed to or created by [[email protected]]. See [ [email protected]] for more details. The [[email protected]:value] field sets the position of the thumb and must be between [ [email protected]:lower] and [[email protected]:upper] - [[email protected]:page-size]. The [ [email protected]:page-size] represents the size of the visible scrollable area.

The fields [[email protected]:step-increment] and [[email protected]:page-increment] fields are added to or subtracted from the [[email protected]:value] when the user asks to move by a step (using e.g. the cursor arrow keys) or by a page (using e.g. the Page Down/Up keys).

CSS nodes

``` scrollbar ╰── range[.fine-tune] ╰── trough ╰── slider ```

`GtkScrollbar` has a main CSS node with name scrollbar and a subnode for its contents. The main node gets the .horizontal or .vertical style classes applied, depending on the scrollbar's orientation.

The range node gets the style class .fine-tune added when the scrollbar is in 'fine-tuning' mode.

Other style classes that may be added to scrollbars inside [[email protected]] include the positional classes (.left, .right, .top, .bottom) and style classes related to overlay scrolling (.overlay-indicator, .dragging, .hovering).

Accessibility

`GtkScrollbar` uses the gtk_accessible_role_scrollbar role.