GtkNumerableIcon

gtk_numerable_icon_new ()

GIcon *
gtk_numerable_icon_new (GIcon *base_icon);

Creates a new unthemed GtkNumerableIcon.

Since: 3.0

gtk_numerable_icon_new_with_style_context ()

GIcon *
gtk_numerable_icon_new_with_style_context
                               (GIcon *base_icon,
                                GtkStyleContext *context);

Creates a new GtkNumerableIcon which will themed according to the passed GtkStyleContext. This is a convenience constructor that calls gtk_numerable_icon_set_style_context() internally.

Since: 3.0

gtk_numerable_icon_get_background_gicon ()

GIcon *
gtk_numerable_icon_get_background_gicon
                               (GtkNumerableIcon *self);

Returns the GIcon that was set as the base background image, or NULL if there’s none. The caller of this function does not own a reference to the returned GIcon.

Since: 3.0

gtk_numerable_icon_set_background_gicon ()

void
gtk_numerable_icon_set_background_gicon
                               (GtkNumerableIcon *self,
                                GIcon *icon);

Updates the icon to use icon as the base background image. If icon is NULL, self will go back using style information or default theming for its background image.

If this method is called and an icon name was already set as background for the icon, icon will be used, i.e. the last method called between gtk_numerable_icon_set_background_gicon() and gtk_numerable_icon_set_background_icon_name() has always priority.

Since: 3.0

gtk_numerable_icon_get_background_icon_name ()

const gchar *
gtk_numerable_icon_get_background_icon_name
                               (GtkNumerableIcon *self);

Returns the icon name used as the base background image, or NULL if there’s none.

Since: 3.0

gtk_numerable_icon_set_background_icon_name ()

void
gtk_numerable_icon_set_background_icon_name
                               (GtkNumerableIcon *self,
                                const gchar *icon_name);

Updates the icon to use the icon named icon_name from the current icon theme as the base background image. If icon_name is NULL, self will go back using style information or default theming for its background image.

If this method is called and a GIcon was already set as background for the icon, icon_name will be used, i.e. the last method called between gtk_numerable_icon_set_background_icon_name() and gtk_numerable_icon_set_background_gicon() has always priority.

Since: 3.0

gtk_numerable_icon_get_count ()

gint
gtk_numerable_icon_get_count (GtkNumerableIcon *self);

Returns the value currently displayed by self .

Since: 3.0

gtk_numerable_icon_set_count ()

void
gtk_numerable_icon_set_count (GtkNumerableIcon *self,
                              gint count);

Sets the currently displayed value of self to count .

The numeric value is always clamped to make it two digits, i.e. between -99 and 99. Setting a count of zero removes the emblem. If this method is called, and a label was already set on the icon, it will automatically be reset to NULL before rendering the number, i.e. the last method called between gtk_numerable_icon_set_count() and gtk_numerable_icon_set_label() has always priority.

Since: 3.0

gtk_numerable_icon_get_label ()

const gchar *
gtk_numerable_icon_get_label (GtkNumerableIcon *self);

Returns the currently displayed label of the icon, or NULL.

Since: 3.0

gtk_numerable_icon_set_label ()

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

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.

Since: 3.0

gtk_numerable_icon_get_style_context ()

GtkStyleContext *
gtk_numerable_icon_get_style_context (GtkNumerableIcon *self);

Returns the GtkStyleContext used by the icon for theming, or NULL if there’s none.

Since: 3.0

gtk_numerable_icon_set_style_context ()

void
gtk_numerable_icon_set_style_context (GtkNumerableIcon *self,
                                      GtkStyleContext *style);

Updates the icon to fetch theme information from the given GtkStyleContext.

Since: 3.0

struct GtkNumerableIcon

struct GtkNumerableIcon;

The “background-icon” property

  “background-icon”          GIcon *

The icon for the number emblem background.

Owner: GtkNumerableIcon

Flags: Read / Write

The “background-icon-name” property

  “background-icon-name”     char *

The icon name for the number emblem background.

Owner: GtkNumerableIcon

Flags: Read / Write

Default value: NULL

The “count” property

  “count”                    int

The count of the emblem currently displayed.

Owner: GtkNumerableIcon

Flags: Read / Write

Allowed values: [-99,99]

Default value: 0

The “label” property

  “label”                    char *

The label to be displayed over the icon.

Owner: GtkNumerableIcon

Flags: Read / Write

Default value: NULL

The “style-context” property

  “style-context”            GtkStyleContext *

The style context to theme the icon appearance.

Owner: GtkNumerableIcon

Flags: Read / Write