enum OssoABookPresenceState

typedef enum {
        OSSO_ABOOK_PRESENCE_STATE_YES,
        OSSO_ABOOK_PRESENCE_STATE_NO,
        OSSO_ABOOK_PRESENCE_STATE_LOCAL_PENDING,
        OSSO_ABOOK_PRESENCE_STATE_REMOTE_PENDING,
} OssoABookPresenceState;

The various possible states of presence information. A simple boolean flag is not sufficient for representing this information, since presence state can depend on manual feedback and actual network conditions.

OssoABookPresenceIface

typedef struct {
        TpConnectionPresenceType (* get_presence_type)           (OssoABookPresence *presence);
        const char *             (* get_presence_status)         (OssoABookPresence *presence);
        const char *             (* get_presence_status_message) (OssoABookPresence *presence);
        const char *             (* get_location_string)         (OssoABookPresence *presence);

        OssoABookPresenceState   (* get_blocked)                 (OssoABookPresence *presence);
        OssoABookPresenceState   (* get_published)               (OssoABookPresence *presence);
        OssoABookPresenceState   (* get_subscribed)              (OssoABookPresence *presence);
        guint                    (* get_handle)                  (OssoABookPresence *presence);
} OssoABookPresenceIface;

Virtual methods of the OssoABookPresence interface.

osso_abook_presence_get_presence_type ()

TpConnectionPresenceType osso_abook_presence_get_presence_type
                                                        (OssoABookPresence *presence);

Retrieves the presence type of presence. Note that the "presence-type" property can be monitored by connecting to the GObject "notify" signal with "presence-status" as detail, i.e. "notify::presence-type".

osso_abook_presence_get_presence_status ()

const char*         osso_abook_presence_get_presence_status
                                                        (OssoABookPresence *presence);

Retrieves the status of presence as string.

osso_abook_presence_get_display_status ()

const char*         osso_abook_presence_get_display_status
                                                        (OssoABookPresence *presence);

osso_abook_presence_get_presence_status_message ()

const char*         osso_abook_presence_get_presence_status_message
                                                        (OssoABookPresence *presence);

Retrieves the message associated with the status of presence

osso_abook_presence_get_location_string ()

const char*         osso_abook_presence_get_location_string
                                                        (OssoABookPresence *presence);

Retrieves the location associated with the status of presence as string.

osso_abook_presence_get_icon_name ()

const char*         osso_abook_presence_get_icon_name   (OssoABookPresence *presence);

Retrieves the icon name associated with the current status of presence. The icon name can be used to look up the appropriate icon to represent presence until the "presence-status" property changes.

osso_abook_presence_get_branded_icon_name ()

const char*         osso_abook_presence_get_branded_icon_name
                                                        (OssoABookPresence *presence,
                                                         McProfile *profile);

Retrieves the protocol-brand-specific icon name associated with the current status of presence. The icon name can be used to look up the appropriate icon to represent presence until the "presence-status" property changes.

osso_abook_presence_get_blocked ()

OssoABookPresenceState osso_abook_presence_get_blocked  (OssoABookPresence *presence);

Retrieves current blocking status of presence.

osso_abook_presence_get_published ()

OssoABookPresenceState osso_abook_presence_get_published
                                                        (OssoABookPresence *presence);

Retrieves current publication status of presence.

osso_abook_presence_get_subscribed ()

OssoABookPresenceState osso_abook_presence_get_subscribed
                                                        (OssoABookPresence *presence);

Retrieves current subscription status of presence.

osso_abook_presence_get_handle ()

guint               osso_abook_presence_get_handle      (OssoABookPresence *presence);

Retrieves the Telepathy connection handle associated with the presence.

osso_abook_presence_compare ()

int                 osso_abook_presence_compare         (OssoABookPresence *a,
                                                         OssoABookPresence *b);

Compares the status of presence a to the status of presence b. See TpConnectionPresenceType for the weights assigned to different statuses.