GTK+ Reference Manual | ||||
---|---|---|---|---|
#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.
adjustment : |
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.
min : |
minimum value |
max : |
maximum value |
step : |
step increment (tick size) used with keyboard shortcuts |
Returns : | a new GtkHScale |