|  |  |  | libempathy Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
                    EmpathyContact;
                    EmpathyAvatar;
enum                EmpathyCapabilities;
EmpathyContact *    empathy_contact_new                 (TpContact *tp_contact);
EmpathyContact *    empathy_contact_new_for_log         (EmpathyAccount *account,
                                                         const gchar *id,
                                                         const gchar *name,
                                                         gboolean is_user);
TpContact *         empathy_contact_get_tp_contact      (EmpathyContact *contact);
const gchar *       empathy_contact_get_id              (EmpathyContact *contact);
void                empathy_contact_set_id              (EmpathyContact *contact,
                                                         const gchar *id);
const gchar *       empathy_contact_get_name            (EmpathyContact *contact);
void                empathy_contact_set_name            (EmpathyContact *contact,
                                                         const gchar *name);
EmpathyAvatar *     empathy_contact_get_avatar          (EmpathyContact *contact);
void                empathy_contact_set_avatar          (EmpathyContact *contact,
                                                         EmpathyAvatar *avatar);
EmpathyAccount *    empathy_contact_get_account         (EmpathyContact *contact);
TpConnection *      empathy_contact_get_connection      (EmpathyContact *contact);
TpConnectionPresenceType  empathy_contact_get_presence  (EmpathyContact *contact);
void                empathy_contact_set_presence        (EmpathyContact *contact,
                                                         TpConnectionPresenceType presence);
const gchar *       empathy_contact_get_presence_message
                                                        (EmpathyContact *contact);
void                empathy_contact_set_presence_message
                                                        (EmpathyContact *contact,
                                                         const gchar *message);
guint               empathy_contact_get_handle          (EmpathyContact *contact);
void                empathy_contact_set_handle          (EmpathyContact *contact,
                                                         guint handle);
EmpathyCapabilities  empathy_contact_get_capabilities   (EmpathyContact *contact);
void                empathy_contact_set_capabilities    (EmpathyContact *contact,
                                                         EmpathyCapabilities capabilities);
gboolean            empathy_contact_is_user             (EmpathyContact *contact);
void                empathy_contact_set_is_user         (EmpathyContact *contact,
                                                         gboolean is_user);
gboolean            empathy_contact_is_online           (EmpathyContact *contact);
const gchar *       empathy_contact_get_status          (EmpathyContact *contact);
gboolean            empathy_contact_can_voip            (EmpathyContact *contact);
gboolean            empathy_contact_can_send_files      (EmpathyContact *contact);
guint               empathy_contact_hash                (gconstpointer key);
void                empathy_contact_load_avatar_data    (EmpathyContact *contact,
                                                         const guchar *data,
                                                         const gsize len,
                                                         const gchar *format,
                                                         const gchar *token);
gboolean            empathy_contact_load_avatar_cache   (EmpathyContact *contact,
                                                         const gchar *token);
#define             EMPATHY_TYPE_AVATAR
GType               empathy_avatar_get_type             (void);
EmpathyAvatar *     empathy_avatar_new                  (guchar *data,
                                                         gsize len,
                                                         gchar *format,
                                                         gchar *token,
                                                         gchar *filename);
EmpathyAvatar *     empathy_avatar_ref                  (EmpathyAvatar *avatar);
void                empathy_avatar_unref                (EmpathyAvatar *avatar);
gboolean            empathy_avatar_save_to_file         (EmpathyAvatar *avatar,
                                                         const gchar *filename,
                                                         GError **error);
"account" EmpathyAccount* : Read / Write / Construct Only "avatar" EmpathyAvatar* : Read / Write "capabilities" EmpathyCapabilities : Read / Write / Construct "handle" guint : Read / Write "id" gchar* : Read / Write "is-user" gboolean : Read / Write "location" GHashTable* : Read "name" gchar* : Read / Write "presence" guint : Read / Write "presence-message" gchar* : Read / Write "tp-contact" TpContact* : Read / Write / Construct Only
typedef struct {
  guchar *data;
  gsize len;
  gchar *format;
  gchar *token;
  gchar *filename;
  guint refcount;
} EmpathyAvatar;
typedef enum {
  EMPATHY_CAPABILITIES_NONE = 0,
  EMPATHY_CAPABILITIES_AUDIO = 1 << 0,
  EMPATHY_CAPABILITIES_VIDEO = 1 << 1,
  EMPATHY_CAPABILITIES_FT = 1 << 2,
  EMPATHY_CAPABILITIES_STREAM_TUBE = 1 << 3,
  EMPATHY_CAPABILITIES_UNKNOWN = 1 << 7
} EmpathyCapabilities;
EmpathyContact * empathy_contact_new (TpContact *tp_contact);
| 
 | |
| Returns : | 
EmpathyContact * empathy_contact_new_for_log (EmpathyAccount *account, const gchar *id, const gchar *name, gboolean is_user);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
TpContact * empathy_contact_get_tp_contact (EmpathyContact *contact);
| 
 | |
| Returns : | 
const gchar * empathy_contact_get_id (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_id (EmpathyContact *contact, const gchar *id);
| 
 | |
| 
 | 
const gchar * empathy_contact_get_name (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_name (EmpathyContact *contact, const gchar *name);
| 
 | |
| 
 | 
EmpathyAvatar * empathy_contact_get_avatar (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_avatar (EmpathyContact *contact, EmpathyAvatar *avatar);
| 
 | |
| 
 | 
EmpathyAccount * empathy_contact_get_account (EmpathyContact *contact);
| 
 | |
| Returns : | 
TpConnection * empathy_contact_get_connection (EmpathyContact *contact);
| 
 | |
| Returns : | 
TpConnectionPresenceType empathy_contact_get_presence (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_presence (EmpathyContact *contact, TpConnectionPresenceType presence);
| 
 | |
| 
 | 
const gchar * empathy_contact_get_presence_message (EmpathyContact *contact);
| 
 | |
| Returns : | 
void                empathy_contact_set_presence_message
                                                        (EmpathyContact *contact,
                                                         const gchar *message);
| 
 | |
| 
 | 
guint empathy_contact_get_handle (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_handle (EmpathyContact *contact, guint handle);
| 
 | |
| 
 | 
EmpathyCapabilities empathy_contact_get_capabilities (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_capabilities (EmpathyContact *contact, EmpathyCapabilities capabilities);
| 
 | |
| 
 | 
gboolean empathy_contact_is_user (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_is_user (EmpathyContact *contact, gboolean is_user);
| 
 | |
| 
 | 
gboolean empathy_contact_is_online (EmpathyContact *contact);
| 
 | |
| Returns : | 
const gchar * empathy_contact_get_status (EmpathyContact *contact);
| 
 | |
| Returns : | 
gboolean empathy_contact_can_voip (EmpathyContact *contact);
| 
 | |
| Returns : | 
gboolean empathy_contact_can_send_files (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_load_avatar_data (EmpathyContact *contact, const guchar *data, const gsize len, const gchar *format, const gchar *token);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | 
gboolean empathy_contact_load_avatar_cache (EmpathyContact *contact, const gchar *token);
| 
 | |
| 
 | |
| Returns : | 
EmpathyAvatar * empathy_avatar_new (guchar *data, gsize len, gchar *format, gchar *token, gchar *filename);
Create a EmpathyAvatar from the provided data. This function takes the
ownership of data, format, token and filename.
| 
 | the avatar data | 
| 
 | the size of avatar data | 
| 
 | the mime type of the avatar image | 
| 
 | the token of the avatar | 
| 
 | the filename where the avatar is stored in cache | 
| Returns : | a new EmpathyAvatar | 
EmpathyAvatar * empathy_avatar_ref (EmpathyAvatar *avatar);
| 
 | |
| Returns : | 
gboolean empathy_avatar_save_to_file (EmpathyAvatar *avatar, const gchar *filename, GError **error);
Save the avatar to a file named filename
"account" property"account" EmpathyAccount* : Read / Write / Construct Only
The account associated with the contact.
"capabilities" property"capabilities" EmpathyCapabilities : Read / Write / Construct
Capabilities of the contact.
Default value: EMPATHY_CAPABILITIES_UNKNOWN
"presence" property"presence" guint : Read / Write
Presence of contact.
Allowed values: <= 9
Default value: 0
"presence-message" property"presence-message" gchar* : Read / Write
Presence message of contact.
Default value: NULL
"tp-contact" property"tp-contact" TpContact* : Read / Write / Construct Only
The TpContact associated with the contact.
"presence-changed" signalvoid user_function (EmpathyContact *empathycontact, guint arg1, guint arg2, gpointer user_data) : Run Last
| 
 | the object which received the signal. | 
| 
 | |
| 
 | |
| 
 | user data set when the signal handler was connected. |