|
|
|
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