A container that shows all or part of its child within a scrollable
GtkScrolledWindow is a GtkBin
subclass: it's a container the accepts a single child widget.
GtkScrolledWindow adds scrollbars to the child widget and optionally draws
a beveled frame around the child widget.
The scrolled window can work in two ways. Some widgets have native scrolling
support; these widgets have "slots" for
GtkAdjustment objects. Widgets with native scroll
support include GtkTreeView,
GtkTextView, and GtkLayout.
For widgets that lack native scrolling support, the
GtkViewport widget acts as an adaptor class,
implementing scrollability for child widgets that lack their own scrolling
capabilities. Use GtkViewport to scroll child
widgets such as GtkTable,
GtkBox, and so on.
If a widget has native scrolling abilities, it can be added to the
add() . If a widget does not,
you must first add the widget to a GtkViewport,
then add the GtkViewport to the scrolled window.
The convenience function
exactly this, so you can ignore the presence of the viewport.
The position of the scrollbars is controlled by the scroll adjustments.
See GtkAdjustment for the fields in an adjustment
- for GtkScrollbar, used by
value field represents the
position of the scrollbar, which must be between the
lower field and
The page_size field
represents the size of the visible scrollable area. The
page_increment fields are
used when the user asks to step down (using the small stepper arrows)
or page down (using for example the PageDown key).
If a GtkScrolledWindow doesn't behave quite as you would like, or
doesn't have exactly the right layout, it's very possible to set up your
own scrolling with GtkScrollbar and for example a
Creates a new scrolled window.
Use get_property and set_property methods to access these.
When the horizontal scrollbar is displayed.
Style of bevel around the contents.
When the vertical scrollbar is displayed.
Position of the child relative to the scrollbars.
Can be set with rc files/strings only.
Number of pixels between the scrollbars and the scrolled window.
Focus is moved out of the scrolled window.
Child widget is scrolled by keyboard action.