Class

PurplePresence

since: 2.0

Description [src]

class Purple.Presence : GObject.Object {
  parent_instance: GObject
}

A PurplePresence is like a collection of PurpleStatuses (plus some other random info). For any buddy, or for any one of your accounts, or for any person with which you’re chatting, you may know various amounts of information. This information is all contained in one PurplePresence. If one of your buddies is away and idle, then the presence contains the PurpleStatus for their awayness, and it contains their current idle time. PurplePresences are never saved to disk. The information they contain is only relevant for the current Purple session.

Note: When a presence is destroyed with the last g_object_unref(), all statuses added to this list will be destroyed along with the presence.

Available since: 2.0

Ancestors

Constructors

purple_presence_new

Creates a new presence instance.

since: 2.0

Instance methods

purple_presence_compare

Compares the presences for availability.

since: 2.0

purple_presence_get_emoji

Gets the current emoji, sometimes referred to as a mood, of presence.

since: 3.0

purple_presence_get_idle_time

Gets the idle time of presence. This can be NULL if the protocol doesn’t support idle times or if the presence isn’t in an idle state.

since: 2.0

purple_presence_get_login_time

Gets the login time of presence.

since: 2.0

purple_presence_get_message

Gets the status message for presence if one is set.

since: 3.0

purple_presence_get_mobile

Gets whether or not presence is on a mobile device.

since: 3.0

purple_presence_get_notifications_disabled

Gets whether or not presence has notifications disabled.

since: 3.0

purple_presence_get_primitive

Gets the PurplePresencePrimitive for presence.

since: 3.0

purple_presence_is_available

Gets whether or not presence is available.

since: 2.0

purple_presence_is_idle

Gets whether or not presence is idle.

since: 2.0

purple_presence_is_online

Gets whether or not presence is online.

since: 2.0

purple_presence_set_emoji

Sets the current emoji, sometimes referred to as a mood, of presence to emoji.

since: 3.0

purple_presence_set_idle

Sets the idle state and time of presence.

since: 2.0

purple_presence_set_login_time

Sets the login time on a presence.

since: 2.0

purple_presence_set_message

Sets the status message of presence to message.

since: 3.0

purple_presence_set_mobile

Sets whether or not presence is on a mobile device.

since: 3.0

purple_presence_set_notifications_disabled

Sets whether or not presence has notifications disabled.

since: 3.0

purple_presence_set_primitive

Sets the PurplePresencePrimitive for presence to primitive.

since: 3.0

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Purple.Presence:emoji

The emoji or mood of the presence.

since: 3.0

Purple.Presence:idle

Whether or not the presence is in an idle state.

since: 3.0

Purple.Presence:idle-time

The time when the presence went idle.

since: 3.0

Purple.Presence:login-time

The login-time of the presence.

since: 3.0

Purple.Presence:message

The status message of the presence.

since: 3.0

Purple.Presence:mobile

Whether or not the presence is on a mobile device.

since: 3.0

Purple.Presence:notifications-disabled

Whether or not the presence has notifications disabled.

since: 3.0

Purple.Presence:primitive

The PurplePresencePrimitive for this presence.

since: 3.0

Signals

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Class structure

struct PurplePresenceClass {
  void (* update_idle) (
    PurplePresence* presence,
    gboolean old_idle
  );
  GList* (* get_statuses) (
    PurplePresence* presence
  );
  
}

The base class for all PurplePresences.

Class members
update_idle: void (* update_idle) ( PurplePresence* presence, gboolean old_idle )
No description available.
get_statuses: GList* (* get_statuses) ( PurplePresence* presence )
No description available.

Virtual methods

Purple.PresenceClass.get_statuses
No description available.

Purple.PresenceClass.update_idle
No description available.