Memory-managed wrapper type.

Type class for types which can be safely cast to SpinButton, for instance with toSpinButton.

Cast to SpinButton, for types for which this is known to be safe. For general casts, use castTo.

A convenience alias for Nothing :: Maybe SpinButton.

Changes the properties of an existing spin button. The adjustment, climb rate, and number of decimal places are updated accordingly.

Get the adjustment associated with a SpinButton

Fetches the precision of spinButton. See spinButtonSetDigits.

Gets the current step and page the increments used by spinButton. See spinButtonSetIncrements.

Returns whether non-numeric text can be typed into the spin button. See spinButtonSetNumeric.

Gets the range allowed for spinButton. See spinButtonSetRange.

Returns whether the values are corrected to the nearest step. See spinButtonSetSnapToTicks.

Gets the update behavior of a spin button. See spinButtonSetUpdatePolicy.

Get the value in the spinButton.

Get the value spinButton represented as an integer.

Returns whether the spin button’s value wraps around to the opposite limit when the upper or lower limit of the range is exceeded. See spinButtonSetWrap.

Creates a new SpinButton.

This is a convenience constructor that allows creation of a numeric SpinButton without manually creating an adjustment. The value is initially set to the minimum value and a page increment of 10 * step is the default. The precision of the spin button is equivalent to the precision of step.

Note that the way in which the precision is derived works best if step is a power of ten. If the resulting precision is not suitable for your needs, use spinButtonSetDigits to correct it.

Replaces the Adjustment associated with spinButton.

Set the precision to be displayed by spinButton. Up to 20 digit precision is allowed.

Sets the step and page increments for spin_button. This affects how quickly the value changes when the spin button’s arrows are activated.

Sets the flag that determines if non-numeric text can be typed into the spin button.

Sets the minimum and maximum allowable values for spinButton.

If the current value is outside this range, it will be adjusted to fit within the range, otherwise it will remain unchanged.

Sets the policy as to whether values are corrected to the nearest step increment when a spin button is activated after providing an invalid value.

Sets the update behavior of a spin button. This determines whether the spin button is always updated or only when a valid value is set.

Sets the value of spinButton.

Sets the flag that determines if a spin button value wraps around to the opposite limit when the upper or lower limit of the range is exceeded.

Increment or decrement a spin button’s value in a specified direction by a specified amount.

Manually force an update of the spin button.

Construct a GValueConstruct with valid value for the “adjustment” property. This is rarely needed directly, but it is used by new.

Get the value of the “adjustment” property. When overloading is enabled, this is equivalent to

get spinButton #adjustment

Set the value of the “adjustment” property. When overloading is enabled, this is equivalent to

set spinButton [ #adjustment := value ]

Construct a GValueConstruct with valid value for the “climb-rate” property. This is rarely needed directly, but it is used by new.

Get the value of the “climb-rate” property. When overloading is enabled, this is equivalent to

get spinButton #climbRate

Set the value of the “climb-rate” property. When overloading is enabled, this is equivalent to

set spinButton [ #climbRate := value ]

Construct a GValueConstruct with valid value for the “digits” property. This is rarely needed directly, but it is used by new.

Get the value of the “digits” property. When overloading is enabled, this is equivalent to

get spinButton #digits

Set the value of the “digits” property. When overloading is enabled, this is equivalent to

set spinButton [ #digits := value ]

Construct a GValueConstruct with valid value for the “numeric” property. This is rarely needed directly, but it is used by new.

Get the value of the “numeric” property. When overloading is enabled, this is equivalent to

get spinButton #numeric

Set the value of the “numeric” property. When overloading is enabled, this is equivalent to

set spinButton [ #numeric := value ]

Construct a GValueConstruct with valid value for the “snap-to-ticks” property. This is rarely needed directly, but it is used by new.

Get the value of the “snap-to-ticks” property. When overloading is enabled, this is equivalent to

get spinButton #snapToTicks

Set the value of the “snap-to-ticks” property. When overloading is enabled, this is equivalent to

set spinButton [ #snapToTicks := value ]

Construct a GValueConstruct with valid value for the “update-policy” property. This is rarely needed directly, but it is used by new.

Get the value of the “update-policy” property. When overloading is enabled, this is equivalent to

get spinButton #updatePolicy

Set the value of the “update-policy” property. When overloading is enabled, this is equivalent to

set spinButton [ #updatePolicy := value ]

Construct a GValueConstruct with valid value for the “value” property. This is rarely needed directly, but it is used by new.

Get the value of the “value” property. When overloading is enabled, this is equivalent to

get spinButton #value

Set the value of the “value” property. When overloading is enabled, this is equivalent to

set spinButton [ #value := value ]

Construct a GValueConstruct with valid value for the “wrap” property. This is rarely needed directly, but it is used by new.

Get the value of the “wrap” property. When overloading is enabled, this is equivalent to

get spinButton #wrap

Set the value of the “wrap” property. When overloading is enabled, this is equivalent to

set spinButton [ #wrap := value ]

Type for the callback on the (unwrapped) C side.

The ::change-value signal is a [keybinding signal][GtkBindingSignal] which gets emitted when the user initiates a value change.

Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control the cursor programmatically.

The default bindings for this signal are Up/Down and PageUp and/PageDown.

Connect a signal handler for the “change-value” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after spinButton #changeValue callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_SpinButtonChangeValueCallback.

A convenience synonym for Nothing :: Maybe SpinButtonChangeValueCallback.

Connect a signal handler for the “change-value” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on spinButton #changeValue callback

Wrap a SpinButtonChangeValueCallback into a C_SpinButtonChangeValueCallback.

Type for the callback on the (unwrapped) C side.

The ::input signal can be used to influence the conversion of the users input into a double value. The signal handler is expected to use entryGetText to retrieve the text of the entry and set newValue to the new value.

The default conversion uses strtod.

Connect a signal handler for the “input” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after spinButton #input callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_SpinButtonInputCallback.

A convenience synonym for Nothing :: Maybe SpinButtonInputCallback.

Connect a signal handler for the “input” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on spinButton #input callback

Wrap a SpinButtonInputCallback into a C_SpinButtonInputCallback.

Type for the callback on the (unwrapped) C side.

The ::output signal can be used to change to formatting of the value that is displayed in the spin buttons entry.

C code

// show leading zeros
static gboolean
on_output (GtkSpinButton *spin,
           gpointer       data)
{
   GtkAdjustment *adjustment;
   gchar *text;
   int value;

   adjustment = gtk_spin_button_get_adjustment (spin);
   value = (int)gtk_adjustment_get_value (adjustment);
   text = g_strdup_printf ("%02d", value);
   gtk_entry_set_text (GTK_ENTRY (spin), text);
   g_free (text);

   return TRUE;
}

Connect a signal handler for the “output” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after spinButton #output callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_SpinButtonOutputCallback.

A convenience synonym for Nothing :: Maybe SpinButtonOutputCallback.

Connect a signal handler for the “output” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on spinButton #output callback

Wrap a SpinButtonOutputCallback into a C_SpinButtonOutputCallback.

Type for the callback on the (unwrapped) C side.

The ::value-changed signal is emitted when the value represented by spinbutton changes. Also see the SpinButton::output signal.

Connect a signal handler for the “value-changed” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after spinButton #valueChanged callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_SpinButtonValueChangedCallback.

A convenience synonym for Nothing :: Maybe SpinButtonValueChangedCallback.

Connect a signal handler for the “value-changed” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on spinButton #valueChanged callback

Wrap a SpinButtonValueChangedCallback into a C_SpinButtonValueChangedCallback.

Type for the callback on the (unwrapped) C side.

The ::wrapped signal is emitted right after the spinbutton wraps from its maximum to minimum value or vice-versa.

Since: 2.10

Connect a signal handler for the “wrapped” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after spinButton #wrapped callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_SpinButtonWrappedCallback.

A convenience synonym for Nothing :: Maybe SpinButtonWrappedCallback.

Connect a signal handler for the “wrapped” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on spinButton #wrapped callback

Wrap a SpinButtonWrappedCallback into a C_SpinButtonWrappedCallback.