TplEntity

TplEntity — Representation of a contact or room

Functions

Properties

gchar * alias Read / Write / Construct Only
gchar * avatar-token Read / Write / Construct Only
gchar * identifier Read / Write / Construct Only
gint type Read / Write / Construct Only

Types and Values

Object Hierarchy

    GObject
    ╰── TplEntity

Description

An object representing a contact or room.

Functions

tpl_entity_new ()

TplEntity *
tpl_entity_new (const gchar *id,
                TpEntityType type,
                const gchar *alias,
                const gchar *avatar_token);

tpl_entity_new_from_tp_contact ()

TplEntity *
tpl_entity_new_from_tp_contact (TpContact *contact,
                                TpEntityType type);

Parameters

contact

the TpContact instance to create the TplEntity from

 

type

the TplEntity type

 

Returns

a TplEntity instance with identifier, alias and avatar's token copied. Type parameter is useful to differentiate between normal contact and self contact, thus only TP_ENTITY_TYPE_CONTACT and TP_ENTITY_TYPE_SELF are accepted. If contact is NULL, an entity of type TP_ENTITY_TYPE_NONE with id set to "unknown" is returned.


tpl_entity_new_from_room_id ()

TplEntity *
tpl_entity_new_from_room_id (const gchar *room_id);

Parameters

room_id

the room id which will be the identifier for the entity

 

Returns

a TplEntity instance with identifier, alias copied from room_id . It also sets TP_ENTITY_TYPE_ROOM as type for the TplEntity returned.


tpl_entity_get_alias ()

const gchar *
tpl_entity_get_alias (TplEntity *self);

Parameters

self

a TplEntity

 

Returns

the alias of the entity, or NULL


tpl_entity_get_identifier ()

const gchar *
tpl_entity_get_identifier (TplEntity *self);

Parameters

self

a TplEntity

 

Returns

the identifier of the entity


tpl_entity_get_entity_type ()

TpEntityType
tpl_entity_get_entity_type (TplEntity *self);

Parameters

self

a TplEntity

 

Returns

the type of the entity


tpl_entity_get_avatar_token ()

const gchar *
tpl_entity_get_avatar_token (TplEntity *self);

Parameters

self

a TplEntity

 

Returns

a token representing the avatar of the token, or NULL

Types and Values

TplEntityPriv

typedef struct _TplEntityPriv TplEntityPriv;

Property Details

The “alias” property

  “alias”                    gchar *

The entity's alias

Flags: Read / Write / Construct Only

Default value: NULL


The “avatar-token” property

  “avatar-token”             gchar *

The entity's avatar token

Flags: Read / Write / Construct Only

Default value: NULL


The “identifier” property

  “identifier”               gchar *

The entity's identifier

Flags: Read / Write / Construct Only

Default value: NULL


The “type” property

  “type”                     gint

The entity's type (see TpEntityType).

Flags: Read / Write / Construct Only

Allowed values: [0,3]

Default value: 0