| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> | 
| #include <gtk/gtk.h> struct GtkHScale; GtkWidget* gtk_hscale_new (GtkAdjustment *adjustment); GtkWidget* gtk_hscale_new_with_range (gdouble min, gdouble max, gdouble step); | 
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.
| struct 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.
| min : | minimum value | 
| max : | maximum value | 
| step : | step increment (tick size) used with keyboard shortcuts | 
| Returns : | a new GtkHScale |