 |
 |
 |
GTK+ 3 Reference Manual |  |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Style Properties | ||||
Synopsis
#include <gtk/gtk.h> struct GtkScrollbar; GtkWidget * gtk_scrollbar_new (GtkOrientation orientation,GtkAdjustment *adjustment);
Object Hierarchy
GObject +----GInitiallyUnowned +----GtkWidget +----GtkRange +----GtkScrollbar +----GtkHScrollbar +----GtkVScrollbar
Style Properties
"fixed-slider-length" gboolean : Read "has-backward-stepper" gboolean : Read "has-forward-stepper" gboolean : Read "has-secondary-backward-stepper" gboolean : Read "has-secondary-forward-stepper" gboolean : Read "min-slider-length" gint : Read
Description
The GtkScrollbar widget is the base class for GtkHScrollbar and GtkVScrollbar. It can be used in the same way as these, by setting the "orientation" property appropriately.
The position of the thumb in a scrollbar is controlled by the scroll adjustments. See GtkAdjustment for the fields in an adjustment - for GtkScrollbar, the GtkAdjustment.value field represents the position of the scrollbar, which must be between the GtkAdjustment.lower field and GtkAdjustment.upper - GtkAdjustment.page_size. The GtkAdjustment.page_size field represents the size of the visible scrollable area. The GtkAdjustment.step_increment and GtkAdjustment.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).
Details
gtk_scrollbar_new ()
GtkWidget * gtk_scrollbar_new (GtkOrientation orientation,GtkAdjustment *adjustment);
Creates a new scrollbar with the given orientation.
|
the scrollbar's orientation. |
|
the GtkAdjustment to use, or NULL to create a new adjustment. [allow-none]
|
Returns : |
the new GtkScrollbar. |
Since 3.0
Style Property Details
The "fixed-slider-length" style property
"fixed-slider-length" gboolean : Read
Don't change slider size, just lock it to the minimum length.
Default value: FALSE
The "has-backward-stepper" style property
"has-backward-stepper" gboolean : Read
Display the standard backward arrow button.
Default value: TRUE
The "has-forward-stepper" style property
"has-forward-stepper" gboolean : Read
Display the standard forward arrow button.
Default value: TRUE
The "has-secondary-backward-stepper" style property
"has-secondary-backward-stepper" gboolean : Read
Display a second backward arrow button on the opposite end of the scrollbar.
Default value: FALSE
The "has-secondary-forward-stepper" style property
"has-secondary-forward-stepper" gboolean : Read
Display a second forward arrow button on the opposite end of the scrollbar.
Default value: FALSE
The "min-slider-length" style property
"min-slider-length" gint : Read
Minimum length of scrollbar slider.
Allowed values: >= 0
Default value: 21