|  |  |  | libempathy Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
                    EmpathyContact;
                    EmpathyAvatar;
enum                EmpathyCapabilities;
enum                EmpathyContactReady;
EmpathyContact *    empathy_contact_new                 (McAccount *account);
EmpathyContact *    empathy_contact_new_full            (McAccount *account,
                                                         const gchar *id,
                                                         const gchar *name);
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);
McAccount *         empathy_contact_get_account         (EmpathyContact *contact);
void                empathy_contact_set_account         (EmpathyContact *contact,
                                                         McAccount *account);
McPresence          empathy_contact_get_presence        (EmpathyContact *contact);
void                empathy_contact_set_presence        (EmpathyContact *contact,
                                                         McPresence 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);
EmpathyContactReady  empathy_contact_get_ready          (EmpathyContact *contact);
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);
gboolean            empathy_contact_equal               (gconstpointer v1,
                                                         gconstpointer v2);
guint               empathy_contact_hash                (gconstpointer key);
void                empathy_contact_call_when_ready     (EmpathyContact *contact,
                                                         EmpathyContactReady ready,
                                                         EmpathyContactReadyCb *callback,
                                                         gpointeruser_data ,
                                                         GDestroyNotify destroy,
                                                         GObject *weak_object);
void                empathy_contact_run_until_ready     (EmpathyContact *contact,
                                                         EmpathyContactReady ready,
                                                         GMainLoop **loop);
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);
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" McAccount* : Read / Write "avatar" EmpathyAvatar* : Read / Write "capabilities" EmpathyCapabilities : Read / Write / Construct "handle" guint : Read / Write "id" gchar* : Read / Write "is-user" gboolean : Read / Write "name" gchar* : Read / Write "presence" guint : Read / Write "presence-message" gchar* : Read / Write "ready" EmpathyContactReady : Read
typedef struct {
  guchar *data;
  gsize len;
  gchar *format;
  gchar *token;
  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_UNKNOWN = 1 << 7
} EmpathyCapabilities;
typedef enum {
  EMPATHY_CONTACT_READY_NONE = 0,
  EMPATHY_CONTACT_READY_ID = 1 << 0,
  EMPATHY_CONTACT_READY_HANDLE = 1 << 1,
  EMPATHY_CONTACT_READY_NAME = 1 << 2,
  EMPATHY_CONTACT_READY_ALL = (1 << 3) - 1,
} EmpathyContactReady;
EmpathyContact * empathy_contact_new (McAccount *account);
| 
 | |
| Returns : | 
EmpathyContact * empathy_contact_new_full (McAccount *account, const gchar *id, const gchar *name);
| 
 | |
| 
 | |
| 
 | |
| 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);
| 
 | |
| 
 | 
McAccount * empathy_contact_get_account (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_account (EmpathyContact *contact, McAccount *account);
| 
 | |
| 
 | 
McPresence empathy_contact_get_presence (EmpathyContact *contact);
| 
 | |
| Returns : | 
void empathy_contact_set_presence (EmpathyContact *contact, McPresence 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);
| 
 | |
| 
 | 
EmpathyContactReady empathy_contact_get_ready (EmpathyContact *contact);
| 
 | |
| Returns : | 
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 : | 
gboolean empathy_contact_equal (gconstpointer v1, gconstpointer v2);
| 
 | |
| 
 | |
| Returns : | 
void empathy_contact_call_when_ready (EmpathyContact *contact, EmpathyContactReady ready, EmpathyContactReadyCb *callback, gpointeruser_data , GDestroyNotify destroy, GObject *weak_object);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | 
void empathy_contact_run_until_ready (EmpathyContact *contact, EmpathyContactReady ready, GMainLoop **loop);
| 
 | |
| 
 | |
| 
 | 
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);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
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
"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: <= 7
Default value: 0
"presence-message" property"presence-message" gchar* : Read / Write
Presence message of contact.
Default value: NULL
"presence-changed" signalvoid user_function (EmpathyContact *empathycontact, McPresence arg1, McPresence arg2, gpointer user_data) : Run Last
| 
 | the object which received the signal. | 
| 
 | |
| 
 | |
| 
 | user data set when the signal handler was connected. |