Interface gtk-scrollable

Package: gtk

Superclasses

g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

gtk-layout, gtk-text-view, gtk-tool-palette, gtk-tree-view, gtk-viewport

Direct Slots

hadjustment

The hadjustment property of type gtk-adjustment (Read / Write / Construct)
Horizontal adjustment of the scrollable widget. This adjustment is shared between the scrollable widget and its parent.

hscroll-policy

The hscroll-policy property of type gtk-scrollable-policy (Read / Write)
Determines whether horizontal scrolling should start once the scrollable widget is allocated less than its minimum width or less than its natural width.
Default value: :minimum

vadjustment

The vadjustment property of type gtk-adjustment (Read / Write / Construct)
Vertical adjustment of the scrollable widget. This adjustment is shared between the scrollable widget and its parent.

vscroll-policy

The vscroll-policy property of type gtk-scrollable-policy (Read / Write)
Determines whether vertical scrolling should start once the scrollable widget is allocated less than its minimum height or less than its natural height.
Default value: :minimum

Details

The gtk-scrollable interface is an interface that is implemented by widgets with native scrolling ability.

To implement this interface you should override the hadjustment and vadjustment properties.

Creating a scrollable widget

All scrollable widgets should do the following.

When a parent widget sets the scrollable child widget’s adjustments, the widget should populate the adjustments’ lower, upper, step-increment, page-increment and page-size properties and connect to the "value-changed" signal.
Because its preferred size is the size for a fully expanded widget, the scrollable widget must be able to cope with underallocations. This means that it must accept any value passed to its GtkWidgetClass.size_allocate() function.
When the parent allocates space to the scrollable child widget, the widget should update the adjustments’ properties with new values.
When any of the adjustments emits the "value-changed" signal, the scrollable widget should scroll its contents.