GTK+ 3 Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Style Properties |
#include <gtk/gtk.h> struct GtkScrollbar; GtkWidget * gtk_scrollbar_new (GtkOrientation orientation
,GtkAdjustment *adjustment
);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkRange +----GtkScrollbar +----GtkHScrollbar +----GtkVScrollbar
"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
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).
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
"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
"has-backward-stepper"
style property"has-backward-stepper" gboolean : Read
Display the standard backward arrow button.
Default value: TRUE
"has-forward-stepper"
style property"has-forward-stepper" gboolean : Read
Display the standard forward arrow button.
Default value: TRUE
"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
"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
"min-slider-length"
style property"min-slider-length" gint : Read
Minimum length of scrollbar slider.
Allowed values: >= 0
Default value: 21