<< Back to man.ChinaUnix.net

<< Back to man.ChinaUnix.net

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
   +----GtkObject
         +----GtkWidget
               +----GtkRange
                     +----GtkScale
                           +----GtkHScale

Implemented Interfaces

GtkHScale implements AtkImplementorIface.

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

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