![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkVScale; GtkWidget* gtk_vscale_new (GtkAdjustment *adjustment); GtkWidget* gtk_vscale_new_with_range (gdouble min, gdouble max, gdouble step);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkRange +----GtkScale +----GtkVScale
The GtkVScale widget is used to allow the user to select a value using a vertical 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 _GtkVScale GtkVScale;
The GtkVScale-struct struct contains private data only, and should be accessed using the functions below.
GtkWidget* gtk_vscale_new (GtkAdjustment *adjustment);
Creates a new GtkVScale.
adjustment : | the GtkAdjustment which sets the range of the scale. |
Returns : | a new GtkVScale. |
GtkWidget* gtk_vscale_new_with_range (gdouble min, gdouble max, gdouble step);
Creates a new vertical 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 GtkVScale |