GtkScaleButton

GtkScaleButton — A button which pops up a scale

Synopsis

#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);

Description

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.

Details

GtkScaleButton

typedef struct {
  GtkButton parent;
} GtkScaleButton;


gtk_scale_button_new ()

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.

size :

a stock icon size. [type int]

min :

the minimum value of the scale (usually 0)

max :

the maximum value of the scale (usually 100)

step :

the stepping of value when a scroll-wheel event, or up/down arrow event occurs (usually 2)

icons :

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


gtk_scale_button_set_adjustment ()

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.

button :

a GtkScaleButton

adjustment :

a GtkAdjustment

Since 2.12


gtk_scale_button_set_icons ()

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.

button :

a GtkScaleButton

icons :

a NULL-terminated array of icon names. [array zero-terminated=1]

Since 2.12


gtk_scale_button_set_value ()

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.

button :

a GtkScaleButton

value :

new value of the scale button

Since 2.12


gtk_scale_button_get_adjustment ()

GtkAdjustment *     gtk_scale_button_get_adjustment     (GtkScaleButton *button);

Gets the GtkAdjustment associated with the GtkScaleButton's scale. See gtk_range_get_adjustment() for details.

button :

a GtkScaleButton

Returns :

the adjustment associated with the scale. [transfer none]

Since 2.12


gtk_scale_button_get_value ()

gdouble             gtk_scale_button_get_value          (GtkScaleButton *button);

Gets the current value of the scale button.

button :

a GtkScaleButton

Returns :

current value of the scale button

Since 2.12


gtk_scale_button_get_popup ()

GtkWidget *         gtk_scale_button_get_popup          (GtkScaleButton *button);

Retrieves the popup of the GtkScaleButton.

button :

a GtkScaleButton

Returns :

the popup of the GtkScaleButton. [transfer none]

Since 2.14


gtk_scale_button_get_plus_button ()

GtkWidget *         gtk_scale_button_get_plus_button    (GtkScaleButton *button);

Retrieves the plus button of the GtkScaleButton.

button :

a GtkScaleButton

Returns :

the plus button of the GtkScaleButton. [transfer none]

Since 2.14


gtk_scale_button_get_minus_button ()

GtkWidget *         gtk_scale_button_get_minus_button   (GtkScaleButton *button);

Retrieves the minus button of the GtkScaleButton.

button :

a GtkScaleButton

Returns :

the minus button of the GtkScaleButton. [transfer none]

Since 2.14