GtkScaleButton

GtkScaleButton — A button which pops up a scale

Functions

Types and Values

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;
};