![]() |
![]() |
![]() |
GTK+ 3 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#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
); GtkWidget * gtk_scale_button_get_popup (GtkScaleButton *button
); GtkWidget * gtk_scale_button_get_plus_button (GtkScaleButton *button
); GtkWidget * gtk_scale_button_get_minus_button (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.
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. [type int] |
|
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() . [allow-none][array zero-terminated=1]
|
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 "icons" property.
|
a GtkScaleButton |
|
a NULL -terminated array of icon names. [array zero-terminated=1]
|
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 "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. [transfer none] |
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
GtkWidget * gtk_scale_button_get_popup (GtkScaleButton *button
);
Retrieves the popup of the GtkScaleButton.
|
a GtkScaleButton |
Returns : |
the popup of the GtkScaleButton. [transfer none] |
Since 2.14
GtkWidget * gtk_scale_button_get_plus_button (GtkScaleButton *button
);
Retrieves the plus button of the GtkScaleButton.
|
a GtkScaleButton |
Returns : |
the plus button of the GtkScaleButton. [transfer none] |
Since 2.14
GtkWidget * gtk_scale_button_get_minus_button (GtkScaleButton *button
);
Retrieves the minus button of the GtkScaleButton.
|
a GtkScaleButton |
Returns : |
the minus button of the GtkScaleButton. [transfer none] |
Since 2.14