Signal

Gtk Scale::format-value

Declaration

gchar*
format_value(
GtkScale*self,
gdoublevalue,
gpointeruser_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<—”.

staticgchar*
format_value_callback(GtkScale*scale,
gdoublevalue)
{
returng_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.