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 a horizontal or vertical scrollbar, depending on the value of the "orientation" property.
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 "value" field represents the position of the scrollbar, which must be between the "lower" field and "upper" - "page-size". The "page-size" field represents the size of the visible scrollable area. The "step-increment" and "page-increment" fields are properties 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