GEmblem: GIO Reference Manual

## GEmblem GEmblem — An object for emblems |

## Functions

GEmblem * | g_emblem_new ()
GEmblem * | g_emblem_new_with_origin ()
GIcon * | g_emblem_get_icon ()
GEmblemOrigin | g_emblem_get_origin ()

## Properties

GObject * | icon | Read / Write / Construct Only
GEmblemOrigin | origin | Read / Write / Construct Only

## Types and Values

| GEmblem
enum | GEmblemOrigin

## Object Hierarchy

        GObject
        ╰── GEmblem

## Implemented Interfaces

GEmblem implements GIcon.

## Includes

    #include <gio/gio.h>

## Description

GEmblem is an implementation of GIcon that supports having an emblem, which is an icon with additional properties. It can than be added to a GEmblemedIcon.

Currently, only metainformation about the emblem's origin is supported. More may be added in the future.

## Functions

### g_emblem_new ()

    GEmblem *
    g_emblem_new (GIcon *icon);

Creates a new emblem for `icon` .

#### Parameters

icon | a GIcon containing the icon. |

#### Returns

a new GEmblem.

Since: 2.18

### g_emblem_new_with_origin ()

    GEmblem *
    g_emblem_new_with_origin (GIcon *icon,
                              GEmblemOrigin origin);

Creates a new emblem for `icon` .

#### Parameters

icon | a GIcon containing the icon. |
origin | a GEmblemOrigin enum defining the emblem's origin |

#### Returns

a new GEmblem.

Since: 2.18

### g_emblem_get_icon ()

    GIcon *
    g_emblem_get_icon (GEmblem *emblem);

Gives back the icon from `emblem` .

#### Parameters

emblem | a GEmblem from which the icon should be extracted. |

#### Returns

a GIcon. The returned object belongs to the emblem and should not be modified or freed.

[transfer none]

Since: 2.18

### g_emblem_get_origin ()

    GEmblemOrigin
    g_emblem_get_origin (GEmblem *emblem);

Gets the origin of the emblem.

#### Parameters

emblem | a GEmblem |

#### Returns

the origin of the emblem.

[transfer none]

Since: 2.18

## Types and Values

### GEmblem

    typedef struct _GEmblem GEmblem;

An object for Emblems

### enum GEmblemOrigin

GEmblemOrigin is used to add information about the origin of the emblem to GEmblem.

#### Members

G_EMBLEM_ORIGIN_UNKNOWN | Emblem of unknown origin |
G_EMBLEM_ORIGIN_DEVICE | Emblem adds device-specific information |
G_EMBLEM_ORIGIN_LIVEMETADATA | Emblem depicts live metadata, such as "readonly" |
G_EMBLEM_ORIGIN_TAG | Emblem comes from a user-defined tag, e.g. set by nautilus (in the future) |

Since: 2.18

## Property Details

### The `“icon”` property

      “icon”                     GObject *

The actual icon of the emblem.

Flags: Read / Write / Construct Only

### The `“origin”` property

      “origin”                   GEmblemOrigin

Tells which origin the emblem is derived from.

Flags: Read / Write / Construct Only

Default value: G_EMBLEM_ORIGIN_UNKNOWN

## See Also

GIcon, GEmblemedIcon, GLoadableIcon, GThemedIcon