GTK+ Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces |
#include <gtk/gtk.h> GtkHScale; GtkWidget* gtk_hscale_new (GtkAdjustment *adjustment
); GtkWidget* gtk_hscale_new_with_range (gdouble min
,gdouble max
,gdouble step
);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkRange +----GtkScale +----GtkHScale
The GtkHScale widget is used to allow the user to select a value using
a horizontal slider. To create one, use gtk_hscale_new_with_range()
.
The position to show the current value, and the number of decimal places shown can be set using the parent GtkScale class's functions.
typedef struct _GtkHScale GtkHScale;
The GtkHScale struct contains private data only, and should be accessed using the functions below.
GtkWidget* gtk_hscale_new (GtkAdjustment *adjustment
);
Creates a new GtkHScale.
|
the GtkAdjustment which sets the range of the scale. |
Returns : |
a new GtkHScale. |
GtkWidget* gtk_hscale_new_with_range (gdouble min
,gdouble max
,gdouble step
);
Creates a new horizontal scale widget that lets the user input a
number between min
and max
(including min
and max
) with the
increment step
. step
must be nonzero; it's the distance the
slider moves when using the arrow keys to adjust the scale value.
Note that the way in which the precision is derived works best if step
is a power of ten. If the resulting precision is not suitable for your
needs, use gtk_scale_set_digits()
to correct it.
|
minimum value |
|
maximum value |
|
step increment (tick size) used with keyboard shortcuts |
Returns : |
a new GtkHScale |