![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkScaleButton; GtkWidget* gtk_scale_button_new (GtkIconSize size, gdouble min, gdouble max, gdouble step, const gchar **icons); void gtk_scale_button_set_adjustment (GtkScaleButton *button, GtkAdjustment *adjustment); void gtk_scale_button_set_icons (GtkScaleButton *button, const gchar **icons); void gtk_scale_button_set_value (GtkScaleButton *button, gdouble value); GtkAdjustment* gtk_scale_button_get_adjustment (GtkScaleButton *button); gdouble gtk_scale_button_get_value (GtkScaleButton *button);
GtkScaleButton provides a button which pops up a scale widget. This kind of widget is commonly used for volume controls in multimedia applications, and GTK+ provides a GtkVolumeButton subclass that is tailored for this use case.
typedef struct { GtkButton parent; GtkWidget *plus_button; GtkWidget *minus_button; } GtkScaleButton;
GtkWidget* gtk_scale_button_new (GtkIconSize size, gdouble min, gdouble max, gdouble step, const gchar **icons);
Creates a GtkScaleButton, with a range between min
and max
, with
a stepping of step
.
|
a stock icon size |
|
the minimum value of the scale (usually 0) |
|
the maximum value of the scale (usually 100) |
|
the stepping of value when a scroll-wheel event, or up/down arrow event occurs (usually 2) |
|
a NULL -terminated array of icon names, or NULL if
you want to set the list later with gtk_scale_button_set_icons()
|
Returns : |
a new GtkScaleButton |
Since 2.12
void gtk_scale_button_set_adjustment (GtkScaleButton *button, GtkAdjustment *adjustment);
Sets the GtkAdjustment to be used as a model
for the GtkScaleButton's scale.
See gtk_range_set_adjustment()
for details.
|
a GtkScaleButton |
|
a GtkAdjustment |
Since 2.12
void gtk_scale_button_set_icons (GtkScaleButton *button, const gchar **icons);
Sets the icons to be used by the scale button. For details, see the GtkScaleButton:icons property.
|
a GtkScaleButton |
|
a NULL -terminated array of icon names
|
Since 2.12
void gtk_scale_button_set_value (GtkScaleButton *button, gdouble value);
Sets the current value of the scale; if the value is outside the minimum or maximum range values, it will be clamped to fit inside them. The scale button emits the GtkScaleButton::value-changed signal if the value changes.
|
a GtkScaleButton |
|
new value of the scale button |
Since 2.12
GtkAdjustment* gtk_scale_button_get_adjustment (GtkScaleButton *button);
Gets the GtkAdjustment associated with the GtkScaleButton's scale.
See gtk_range_get_adjustment()
for details.
|
a GtkScaleButton |
Returns : |
the adjustment associated with the scale |
Since 2.12
gdouble gtk_scale_button_get_value (GtkScaleButton *button);
Gets the current value of the scale button.
|
a GtkScaleButton |
Returns : |
current value of the scale button |
Since 2.12