GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkVScale

## Name

GtkVScale -- a vertical slider widget for selecting a value from a range.

## Synopsis

    #include <gtk/gtk.h>

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

## Object Hierarchy

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

## 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

### struct GtkVScale

    struct 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.

`min` : | minimum value
`max` : | maximum value
`step` : | step increment (tick size) used with keyboard shortcuts
Returns : | a new GtkVScale

<<< Previous Page | Home | Up | Next Page >>>
GtkHScale | GtkSpinButton