GtkNumerableIcon

GtkNumerableIcon — A GIcon that allows numbered emblems

Functions

Properties

GIcon * background-icon Read / Write
gchar * background-icon-name Read / Write
gint count Read / Write
gchar * label Read / Write
GtkStyleContext * style-context Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GEmblemedIcon
        ╰── GtkNumerableIcon

Implemented Interfaces

GtkNumerableIcon implements GIcon.

Includes

#include <gtk/gtk.h>

Description

GtkNumerableIcon is a subclass of GEmblemedIcon that can show a number or short string as an emblem. The number can be overlayed on top of another emblem, if desired.

It supports theming by taking font and color information from a provided GtkStyleContext; see gtk_numerable_icon_set_style_context().

Typical numerable icons:

Functions

gtk_numerable_icon_new ()

GIcon *
gtk_numerable_icon_new (GIcon *base_icon);

gtk_numerable_icon_new has been deprecated since version 3.14 and should not be used in newly-written code.

Creates a new unthemed GtkNumerableIcon.

Parameters

base_icon

a GIcon to overlay on

 

Returns

a new GIcon.

[transfer full]

Since: 3.0


gtk_numerable_icon_new_with_style_context ()

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

gtk_numerable_icon_new_with_style_context has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

base_icon

a GIcon to overlay on

 

context

a GtkStyleContext

 

Returns

a new GIcon.

[transfer full]

Since: 3.0


gtk_numerable_icon_get_background_gicon ()

GIcon *
gtk_numerable_icon_get_background_gicon
                               (GtkNumerableIcon *self);

gtk_numerable_icon_get_background_gicon has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

self

a GtkNumerableIcon

 

Returns

a GIcon, or NULL.

[nullable][transfer none]

Since: 3.0


gtk_numerable_icon_set_background_gicon ()

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

gtk_numerable_icon_set_background_gicon has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

self

a GtkNumerableIcon

 

icon

a GIcon, or NULL.

[allow-none]

Since: 3.0


gtk_numerable_icon_get_background_icon_name ()

const gchar *
gtk_numerable_icon_get_background_icon_name
                               (GtkNumerableIcon *self);

gtk_numerable_icon_get_background_icon_name has been deprecated since version 3.14 and should not be used in newly-written code.

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

Parameters

self

a GtkNumerableIcon

 

Returns

an icon name, or NULL.

[nullable]

Since: 3.0


gtk_numerable_icon_set_background_icon_name ()

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

gtk_numerable_icon_set_background_icon_name has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

self

a GtkNumerableIcon

 

icon_name

an icon name, or NULL.

[allow-none]

Since: 3.0


gtk_numerable_icon_get_count ()

gint
gtk_numerable_icon_get_count (GtkNumerableIcon *self);

gtk_numerable_icon_get_count has been deprecated since version 3.14 and should not be used in newly-written code.

Returns the value currently displayed by self .

Parameters

self

a GtkNumerableIcon

 

Returns

the currently displayed value

Since: 3.0


gtk_numerable_icon_set_count ()

void
gtk_numerable_icon_set_count (GtkNumerableIcon *self,
                              gint count);

gtk_numerable_icon_set_count has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

self

a GtkNumerableIcon

 

count

a number between -99 and 99

 

Since: 3.0


gtk_numerable_icon_get_label ()

const gchar *
gtk_numerable_icon_get_label (GtkNumerableIcon *self);

gtk_numerable_icon_get_label has been deprecated since version 3.14 and should not be used in newly-written code.

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

Parameters

self

a GtkNumerableIcon

 

Returns

the currently displayed label.

[nullable]

Since: 3.0


gtk_numerable_icon_set_label ()

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

gtk_numerable_icon_set_label has been deprecated since version 3.14 and should not be used in newly-written code.

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.

Parameters

self

a GtkNumerableIcon

 

label

a short label, or NULL.

[allow-none]

Since: 3.0


gtk_numerable_icon_get_style_context ()

GtkStyleContext *
gtk_numerable_icon_get_style_context (GtkNumerableIcon *self);

gtk_numerable_icon_get_style_context has been deprecated since version 3.14 and should not be used in newly-written code.

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

Parameters

self

a GtkNumerableIcon

 

Returns

a GtkStyleContext, or NULL. This object is internal to GTK+ and should not be unreffed. Use g_object_ref() if you want to keep it around.

[nullable][transfer none]

Since: 3.0


gtk_numerable_icon_set_style_context ()

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

gtk_numerable_icon_set_style_context has been deprecated since version 3.14 and should not be used in newly-written code.

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

Parameters

self

a GtkNumerableIcon

 

style

a GtkStyleContext

 

Since: 3.0

Types and Values

struct GtkNumerableIcon

struct GtkNumerableIcon;

Property Details

The “background-icon” property

  “background-icon”          GIcon *

The icon for the number emblem background.

Flags: Read / Write


The “background-icon-name” property

  “background-icon-name”     gchar *

The icon name for the number emblem background.

Flags: Read / Write

Default value: NULL


The “count” property

  “count”                    gint

The count of the emblem currently displayed.

Flags: Read / Write

Allowed values: [-99,99]

Default value: 0


The “label” property

  “label”                    gchar *

The label to be displayed over the icon.

Flags: Read / Write

Default value: NULL


The “style-context” property

  “style-context”            GtkStyleContext *

The style context to theme the icon appearance.

Flags: Read / Write