Name
GtkDial -- Analog dial widget for number selection.
Object Hierarchy
GtkObject
+----GtkWidget
+----GtkDial |
Description
This widget provides an analog dial widget, similar to, for example, a
physical volume control on a stereo. Dial values can be changable or
read-only for value reporting.
Details
gtk_dial_new ()
GtkWidget* gtk_dial_new (GtkAdjustment *adjustment); |
This function creates a new GtkDial widget, and ties it to a
specified GtkAdjustment. When the dial is moved, the adjustment is
updated, and vice-versa.
gtk_dial_get_adjustment ()
GtkAdjustment* gtk_dial_get_adjustment (GtkDial *dial); |
Retrieves the GtkAdjustment associated with the
GtkDial dial.
gtk_dial_set_update_policy ()
void gtk_dial_set_update_policy (GtkDial *dial,
GtkUpdateType policy); |
Sets the update policy of the GtkDial dial to one of either
GTK_UPDATE_CONTINUOUS, GTK_UPDATE_DISCONTINUOUS, or
GTK_UPDATE_DELAYED. Please see Gtk+ documentation for an
explanation of these values.
gtk_dial_set_adjustment ()
void gtk_dial_set_adjustment (GtkDial *dial,
GtkAdjustment *adjustment); |
Associates a new GtkAdjustment with GtkDial dial
widget. The old adjustment is removed and replaced with the new.
gtk_dial_set_percentage ()
gfloat gtk_dial_set_percentage (GtkDial *dial,
gfloat percent); |
Sets the GtkDial's value to percent of
dial->adjustment->upper. The upper value is set when the
GtkAdjustment is created.
gtk_dial_get_percentage ()
gfloat gtk_dial_get_percentage (GtkDial *dial); |
Retrieves the current percentage held in the dial widget.
gtk_dial_set_value ()
gfloat gtk_dial_set_value (GtkDial *dial,
gfloat value); |
Sets the current value held in the GtkDial's
adjustment object to value.
gtk_dial_get_value ()
gfloat gtk_dial_get_value (GtkDial *dial); |
Retrieves the current value helt in the dial widget.
gtk_dial_set_view_only ()
void gtk_dial_set_view_only (GtkDial *dial,
gboolean view_only); |
Specifies whether or not the user is to be able to
edit the value represented by the dial widget. If view_only is
TRUE, the dial will be set to view-only mode, and the user will not
be able to edit it. If view_only is FALSE, the user will be able
to change the value represented.