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 | |
Embleme 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. |
Since 2.18
GEmblemOrigin g_emblem_get_origin (GEmblem *emblem);
Gets the origin of the emblem.
|
a GEmblem |
Returns : |
the origin of the emblem |
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