Memory-managed wrapper type.

Type class for types which can be safely cast to Scale, for instance with toScale.

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

A convenience alias for Nothing :: Maybe Scale.

Adds a mark at value.

A mark is indicated visually by drawing a tick mark next to the scale, and GTK+ makes it easy for the user to position the scale exactly at the marks value.

If markup is not Nothing, text is shown next to the tick mark.

To remove marks from a scale, use scaleClearMarks.

Since: 2.16

Removes any marks that have been added with scaleAddMark.

Since: 2.16

Gets the number of decimal places that are displayed in the value.

Returns whether the current value is displayed as a string next to the slider.

Returns whether the scale has an origin.

Since: 3.4

Gets the Layout used to display the scale. The returned object is owned by the scale so does not need to be freed by the caller.

Since: 2.4

Obtains the coordinates where the scale will draw the Layout representing the text in the scale. Remember when using the Layout function you need to convert to and from pixels using PANGO_PIXELS() or SCALE.

If the Scale:draw-value property is False, the return values are undefined.

Since: 2.4

Gets the position in which the current value is displayed.

Creates a new Scale.

Since: 3.0

Creates a new scale widget with the given orientation that lets the user input a number between min and max (including min and max) with the increment step. step must be nonzero; it’s the distance the slider moves when using the arrow keys to adjust the scale value.

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 scaleSetDigits to correct it.

Since: 3.0

Sets the number of decimal places that are displayed in the value. Also causes the value of the adjustment to be rounded to this number of digits, so the retrieved value matches the displayed one, if Scale:draw-value is True when the value changes. If you want to enforce rounding the value when Scale:draw-value is False, you can set Range:round-digits instead.

Note that rounding to a small number of digits can interfere with the smooth autoscrolling that is built into Scale. As an alternative, you can use the Scale::format-value signal to format the displayed value yourself.

Specifies whether the current value is displayed as a string next to the slider.

If Scale:has-origin is set to True (the default), the scale will highlight the part of the trough between the origin (bottom or left side) and the current value.

Since: 3.4

Sets the position in which the current value is displayed.

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 scale #digits

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

set scale [ #digits := value ]

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

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

get scale #drawValue

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

set scale [ #drawValue := value ]

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

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

get scale #hasOrigin

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

set scale [ #hasOrigin := value ]

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

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

get scale #valuePos

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

set scale [ #valuePos := value ]

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

Signal which allows you to change how the scale value is displayed. Connect a signal handler which returns an allocated string representing value. That string will then be used to display the scale's value.

If no user-provided handlers are installed, the value will be displayed on its own, rounded according to the value of the Scale:digits property.

Here's an example signal handler which displays a value 1.0 as with "-->1.0<--".

C code

static gchar*
format_value_callback (GtkScale *scale,
                       gdouble   value)
{
  return g_strdup_printf ("-->\%0.*g<--",
                          gtk_scale_get_digits (scale), value);
 }

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

after scale #formatValue callback

Wrap the callback into a Closure.

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

A convenience synonym for Nothing :: Maybe ScaleFormatValueCallback.

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

on scale #formatValue callback

Wrap a ScaleFormatValueCallback into a C_ScaleFormatValueCallback.