Method

GtkNumerableIconset_label

Declaration [src]

void
gtk_numerable_icon_set_label (
  GtkNumerableIcon* self,
  const gchar* label
)

Description [src]

Sets the currently displayed value of self to the string in label. Setting an empty label removes the emblem.

Note that this is meant for displaying short labels, such as roman numbers, or single letters. For roman numbers, consider using the Unicode characters U+2160 - U+217F. Strings longer than two characters will likely not be rendered very well.

If this method is called, and a number was already set on the icon, it will automatically be reset to zero before rendering the label, i.e. the last method called between gtk_numerable_icon_set_label() and gtk_numerable_icon_set_count() has always priority.

Available since:3.0
Deprecated since:3.14

Please do not use it in newly written code.

Parameters

label

Type: const gchar*

A short label, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.