GtkVScale

GtkVScale — A vertical slider widget for selecting a value from a range

Synopsis


#include <gtk/gtk.h>

                    GtkVScale;
GtkWidget*          gtk_vscale_new                      (GtkAdjustment *adjustment);
GtkWidget*          gtk_vscale_new_with_range           (gdouble min,
                                                         gdouble max,
                                                         gdouble step);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkRange
                           +----GtkScale
                                 +----GtkVScale

Implemented Interfaces

GtkVScale implements AtkImplementorIface and GtkBuildable.

Description

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.

Details

GtkVScale

typedef struct _GtkVScale GtkVScale;

The GtkVScale struct contains private data only, and should be accessed using the functions below.


gtk_vscale_new ()

GtkWidget*          gtk_vscale_new                      (GtkAdjustment *adjustment);

Creates a new GtkVScale.

adjustment : the GtkAdjustment which sets the range of the scale.
Returns : a new GtkVScale.

gtk_vscale_new_with_range ()

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