|  |  |  | GIO Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
#include <gio/gio.h>
                    GEmblem;
enum                GEmblemOrigin;
GEmblem *           g_emblem_new                        (GIcon *icon);
GEmblem *           g_emblem_new_with_origin            (GIcon *icon,
                                                         GEmblemOrigin origin);
GIcon *             g_emblem_get_icon                   (GEmblem *emblem);
GEmblemOrigin       g_emblem_get_origin                 (GEmblem *emblem);
"icon" GObject* : Read / Write / Construct Only "origin" GEmblemOrigin : Read / Write / Construct Only
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.
typedef enum  {
  G_EMBLEM_ORIGIN_UNKNOWN,
  G_EMBLEM_ORIGIN_DEVICE,
  G_EMBLEM_ORIGIN_LIVEMETADATA,
  G_EMBLEM_ORIGIN_TAG
} GEmblemOrigin;
GEmblemOrigin is used to add information about the origin of the emblem to GEmblem.
| Emblem of unknown origin | |
| Emblem adds device-specific information | |
| Emblem depicts live metadata, such as "readonly" | |
| Emblem comes from a user-defined tag, e.g. set by nautilus (in the future) | 
Since 2.18
GEmblem *           g_emblem_new                        (GIcon *icon);
Creates a new emblem for icon.
| 
 | a GIcon containing the icon. | 
| Returns : | a new GEmblem. | 
Since 2.18
GEmblem * g_emblem_new_with_origin (GIcon *icon,GEmblemOrigin origin);
Creates a new emblem for icon.
| 
 | a GIcon containing the icon. | 
| 
 | a GEmblemOrigin enum defining the emblem's origin | 
| Returns : | a new GEmblem. | 
Since 2.18
GIcon *             g_emblem_get_icon                   (GEmblem *emblem);
Gives back the icon from 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
GEmblemOrigin       g_emblem_get_origin                 (GEmblem *emblem);
Gets the origin of the emblem.
| 
 | a GEmblem | 
| Returns : | the origin of the emblem. [transfer none] | 
Since 2.18
"origin" property"origin" GEmblemOrigin : Read / Write / Construct Only
Tells which origin the emblem is derived from.
Default value: G_EMBLEM_ORIGIN_UNKNOWN