## GtkHScale

GtkHScale — A horizontal slider widget for selecting a value from a range

## Synopsis

    #include <gtk/gtk.h>

                        GtkHScale;
    GtkWidget*          gtk_hscale_new                      (GtkAdjustment *adjustment);
    GtkWidget*          gtk_hscale_new_with_range           (gdouble min,
                                                             gdouble max,
                                                             gdouble step);

## Object Hierarchy

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

## Implemented Interfaces

GtkHScale implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Description

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.

## Details

### GtkHScale

    typedef struct _GtkHScale GtkHScale;

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

### gtk_hscale_new ()

    GtkWidget*          gtk_hscale_new                      (GtkAdjustment *adjustment);

Creates a new GtkHScale.

`adjustment` : | the GtkAdjustment which sets the range of the scale.
Returns : | a new GtkHScale.

### gtk_hscale_new_with_range ()

    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