 |
 |
 |
GTK+ Reference Manual |  |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Style Properties | ||||
Synopsis
#include <gtk/gtk.h>
GtkScrollbar;
GtkWidget * gtk_scrollbar_new (GtkOrientation orientation,
GtkAdjustment *adjustment);
Object Hierarchy
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkRange +----GtkScrollbar +----GtkHScrollbar +----GtkVScrollbar
Implemented Interfaces
GtkScrollbar implements AtkImplementorIface, GtkBuildable, GtkSizeRequest and GtkOrientable.
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 "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 used when the user asks to step down (using the small stepper arrows) or page down (using for example the PageDown key).
Details
GtkScrollbar
typedef struct _GtkScrollbar GtkScrollbar;
The GtkScrollbar struct does not contain any public data.
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