GtkScaleButton: GTK+ 4 Reference Manual

## GtkScaleButton GtkScaleButton — A button which pops up a scale |

## Functions

GtkWidget * | gtk_scale_button_new ()
void | gtk_scale_button_set_adjustment ()
void | gtk_scale_button_set_icons ()
void | gtk_scale_button_set_value ()
GtkAdjustment * | gtk_scale_button_get_adjustment ()
gdouble | gtk_scale_button_get_value ()
GtkWidget * | gtk_scale_button_get_popup ()
GtkWidget * | gtk_scale_button_get_plus_button ()
GtkWidget * | gtk_scale_button_get_minus_button ()

## Types and Values

struct | GtkScaleButton

## Includes

    #include <gtk/gtk.h>

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

### CSS nodes

GtkScaleButton has a single CSS node with name button. To differentiate it from a plain GtkButton, it gets the .scale style class.

## Functions

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

#### Parameters

size | a stock icon size (GtkIconSize). | [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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

button | a GtkScaleButton |

#### Returns

the plus button of the GtkScaleButton as a GtkButton.

[transfer none][type Gtk.Button]

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.

#### Parameters

button | a GtkScaleButton |

#### Returns

the minus button of the GtkScaleButton as a GtkButton.

[transfer none][type Gtk.Button]

Since: 2.14

## Types and Values

### struct GtkScaleButton

    struct GtkScaleButton {
      GtkButton parent;
    };