GEmblem

GEmblem — An object for emblems

Synopsis

#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);

Object Hierarchy

  GObject
   +----GEmblem
  GEnum
   +----GEmblemOrigin

Implemented Interfaces

GEmblem implements GIcon.

Properties

  "icon"                     GObject*              : Read / Write / Construct Only
  "origin"                   GEmblemOrigin         : Read / Write / Construct Only

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.

Details

GEmblem

typedef struct _GEmblem GEmblem;

An object for Emblems


enum GEmblemOrigin

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.

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


g_emblem_new ()

GEmblem *           g_emblem_new                        (GIcon *icon);

Creates a new emblem for icon.

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.

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.

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.

emblem :

a GEmblem

Returns :

the origin of the emblem. [transfer none]

Since 2.18

Property Details

The "icon" property

  "icon"                     GObject*              : Read / Write / Construct Only

The actual icon of the emblem.


The "origin" property

  "origin"                   GEmblemOrigin         : Read / Write / Construct Only

Tells which origin the emblem is derived from.

Default value: G_EMBLEM_ORIGIN_UNKNOWN

See Also

GIcon, GEmblemedIcon, GLoadableIcon, GThemedIcon