GtkHScale: GTK+ 2 Reference Manual

GtkHScale

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

Functions

GtkWidget *	gtk_hscale_new ()
GtkWidget *	gtk_hscale_new_with_range ()

Types and Values

struct

GtkHScale

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkRange
                    ╰── GtkScale
                        ╰── GtkHScale

Implemented Interfaces

GtkHScale implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Includes

#include <gtk/gtk.h>

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.

Functions

gtk_hscale_new ()

GtkWidget *
gtk_hscale_new (GtkAdjustment *adjustment);

Creates a new GtkHScale.

Parameters

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.

Parameters

min	minimum value
max	maximum value
step	step increment (tick size) used with keyboard shortcuts

Returns

a new GtkHScale

Types and Values

struct GtkHScale

struct GtkHScale;

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