GtkScrollbar

The gtk.scrollbar.Scrollbar widget is a horizontal or vertical scrollbar.

An example GtkScrollbar

Its position and movement are controlled by the adjustment that is passed to or created by gtk.scrollbar.Scrollbar.new_. See gtk.adjustment.Adjustment for more details. The gtk.adjustment.Adjustment.gdouble field sets the position of the thumb and must be between gtk.adjustment.Adjustment.gdouble and gtk.adjustment.Adjustment.gdouble - property@Gtk.Adjustment:page-size. The property@Gtk.Adjustment:page-size represents the size of the visible scrollable area.

The fields property@Gtk.Adjustment:step-increment and property@Gtk.Adjustment:page-increment fields are added to or subtracted from the gtk.adjustment.Adjustment.gdouble 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

gtk.scrollbar.Scrollbar 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 gtk.scrolled_window.ScrolledWindow include the positional classes (.left, .right, .top, .bottom) and style classes related to overlay scrolling (.overlay-indicator, .dragging, .hovering).

Accessibility

gtk.scrollbar.Scrollbar uses the gtk.types.AccessibleRole.Scrollbar role.

struct GtkScrollbar