Signal

GtkScale::format-value

Declaration

gchar*
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().

Parameters

value

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.