since: 3.0


format_value (
  GtkScale* self,
  gdouble value,
  gpointer user_data

Description [src]

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 GtkScale:digits property.

Here’s an example signal handler which displays a value 1.0 as with “—>1.0<—”.

static gchar*
format_value_callback (GtkScale *scale,
                       gdouble   value)
  return g_strdup_printf ("-->\`0`.*g<--",
                          gtk_scale_get_digits (scale), value);
Default handler:

The default handler is called after the handlers added via g_signal_connect().

Available since: 3.0



Type: gdouble

The value to format.

Return value

Type: gchar*

Allocated string representing value.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.