Class
PurpleAccount
Description [src]
final class Purple.Account : Purple.ContactInfo {
/* No available fields */
}
A PurpleAccount
is the core configuration for connecting to a specific
account. User interfaces typically allow users to create these in a dialog
or wizard.
Constructors
purple_account_new
Creates a new account.
Functions
purple_account_request_close
Close the account request for the given ui handle.
Instance methods
purple_accounts_delete
Deletes an account.
purple_account_add_buddies
Adds a list of buddies to the server-side buddy list.
purple_account_add_buddy
Adds a buddy to the server-side buddy list for the specified account.
purple_account_change_password
Changes the password on the specified account.
purple_account_clear_current_error
Clear an account’s current error state, resetting it to NULL
.
purple_account_clear_settings
Clears all protocol-specific settings on an account.
purple_account_connect
Connects to an account.
purple_account_disconnect
Disconnects from an account.
purple_account_freeze_notify_settings
Increment the freeze count for settings on account
. When the freeze count
is greater than 0, the PurpleAccount::setting-changed
signal will
not be emitted until the freeze count returns to 0.
Available since: 3.0.0
purple_account_get_active_status
Returns the active status for this account. This looks through the PurplePresence associated with this account and returns the PurpleStatus that has its active flag set to “TRUE.” There can be only one active PurpleStatus in a PurplePresence.
purple_account_get_bool
Returns a protocol-specific boolean setting for an account.
purple_account_get_buddy_icon_path
Gets the account’s buddy icon path.
purple_account_get_connection
Returns the account’s connection.
purple_account_get_current_error
Get the error that caused the account to be disconnected, or NULL
if the
account is happily connected or disconnected without an error.
purple_account_get_enabled
Returns whether or not this account is enabled.
purple_account_get_int
Returns a protocol-specific integer setting for an account.
purple_account_get_presence
Returns the account’s presence.
purple_account_get_protocol_id
Returns the account’s protocol ID.
purple_account_get_protocol_name
Returns the account’s protocol name.
purple_account_get_proxy_info
Returns the account’s proxy information.
purple_account_get_remember_password
Returns whether or not this account should save its password.
purple_account_get_require_password
Gets whether or not account
requires a password.
Available since: 3.0.0
purple_account_get_status
Returns the account status with the specified ID.
purple_account_get_status_type
Returns the account status type with the specified ID.
purple_account_get_status_type_with_primitive
Returns the account status type with the specified primitive. Note: It is possible for an account to have more than one PurpleStatusType with the same primitive. In this case, the first PurpleStatusType is returned.
purple_account_get_status_types
Returns the account’s status types.
purple_account_get_string
Returns a protocol-specific string setting for an account.
purple_account_get_user_info
Returns the account’s user information.
purple_account_is_connected
Returns whether or not the account is connected.
purple_account_is_connecting
Returns whether or not the account is connecting.
purple_account_is_disconnected
Returns whether or not the account is disconnected.
purple_account_is_disconnecting
Indicates if the account is currently being disconnected.
Available since: 3.0.0
purple_account_is_status_active
Returns whether or not an account status is active.
purple_account_remove_buddies
Removes a list of buddies from the server-side buddy list.
purple_account_remove_buddy
Removes a buddy from the server-side buddy list.
purple_account_remove_group
Removes a group from the server-side buddy list.
purple_account_request_change_password
Requests information from the user to change the account’s password.
purple_account_request_change_user_info
Requests information from the user to change the account’s user information.
purple_account_request_close_with_account
Close account requests registered for the given PurpleAccount.
purple_account_request_password
Requests a password from the user for the account. Does not set the account password on success; do that in ok_cb if desired.
purple_account_set_bool
Sets a protocol-specific boolean setting for an account.
purple_account_set_buddy_icon_path
Sets the account’s buddy icon path.
purple_account_set_connection
Sets the account’s connection.
purple_account_set_enabled
Sets whether or not this account is enabled.
purple_account_set_int
Sets a protocol-specific integer setting for an account.
purple_account_set_protocol_id
Sets the account’s protocol ID.
purple_account_set_proxy_info
Sets the account’s proxy information.
purple_account_set_remember_password
Sets whether or not this account should save its password.
purple_account_set_require_password
For protocols that have an optional password, this settings tells libpurple
that it should look for a password in the PurpleCredentialManager
or prompt the user if a password can not be found.
Available since: 3.0.0
purple_account_set_status
Activates or deactivates a status.
purple_account_set_status_types
Sets the account’s status types.
purple_account_set_string
Sets a protocol-specific string setting for an account.
purple_account_set_user_info
Sets the account’s user information.
purple_account_supports_offline_message
Whether the account supports sending offline messages to buddy.
purple_account_thaw_notify_settings
Decrements the freeze count for settings on account
.
Available since: 3.0.0
Methods inherited from PurpleContactInfo (20)
purple_contact_info_compare
Compares contacts a
and b
.
Available since: 3.0.0
purple_contact_info_get_alias
Gets the alias for info
.
Available since: 3.0.0
purple_contact_info_get_avatar
Gets the avatar for info
if one is set.
Available since: 3.0.0
purple_contact_info_get_color
Gets the color that should be used to render this contact info. This is a RGB hex code in a string format.
Available since: 3.0.0
purple_contact_info_get_display_name
Gets the display name for info
. The display name is typically set by the
contact and is handled by the protocol plugin.
Available since: 3.0.0
purple_contact_info_get_id
Gets the id of info
.
Available since: 3.0.0
purple_contact_info_get_name_for_display
Gets the name that should be displayed for info
. See
PurpleContactInfo:name-for-display
for more information.
Available since: 3.0.0
purple_contact_info_get_permission
Gets the PurpleContactInfoPermission
for info
.
Available since: 3.0.0
purple_contact_info_get_person
Gets the PurplePerson
that info
belongs to.
Available since: 3.0.0
purple_contact_info_get_presence
Gets the PurplePresence
for info
.
Available since: 3.0.0
purple_contact_info_get_tags
Gets the PurpleTags
instance for info
.
Available since: 3.0.0
purple_contact_info_get_username
Gets the username of info
.
Available since: 3.0.0
purple_contact_info_set_alias
Sets the alias of info
to alias
.
Available since: 3.0.0
purple_contact_info_set_avatar
Sets the avatar for info
to avatar
. If avatar
is NULL
an existing
avatar will be removed.
Available since: 3.0.0
purple_contact_info_set_color
Sets the color to use when rendering info
to color
.
Available since: 3.0.0
purple_contact_info_set_display_name
Sets the display name of info
to display_name
.
Available since: 3.0.0
purple_contact_info_set_id
Sets the identifier of info
to id
. Note, this should be used rarely if
at all. The main intent of this, is for protocols to update the id of an
an account when it is connected if the id is missing.
Available since: 3.0.0
purple_contact_info_set_permission
Sets the permission of info
to permission
.
Available since: 3.0.0
purple_contact_info_set_person
Sets the person that info
belongs to to person
.
Available since: 3.0.0
purple_contact_info_set_username
Sets the username of info
to username
.
Available since: 3.0.0
Properties
Purple.Account:buddy-icon-path
Purple.Account:connection
Purple.Account:enabled
Purple.Account:error
The GError
of the account. This is set when an account enters
an error state and is cleared when a connection attempt is made.
Available since: 3.0.0
Purple.Account:protocol-id
Purple.Account:proxy-info
Purple.Account:remember-password
Purple.Account:require-password
Whether or not this account should require a password. This is only used
if the PurpleProtocol
that this account is for allows optional passwords.
Available since: 3.0.0
Purple.Account:user-info
Properties inherited from PurpleContactInfo (11)
Purple.ContactInfo:alias
The alias for this contact. This is controlled by the libpurple user and may be used by the protocol if it allows for aliasing.
Available since: 3.0.0
Purple.ContactInfo:avatar
The avatar for this contact. This is typically controlled by the protocol and should only be read by others.
Available since: 3.0.0
Purple.ContactInfo:color
The color for this contact. This is an RGB hex code that user interfaces can use when rendering the contact. This may also be controlled via a protocol plugin in the event that the protocol allows people to set a highlight/branding color.
Available since: 3.0.0
Purple.ContactInfo:display-name
The display name for this contact. This is generally set by the person the contact is representing and controlled via the protocol plugin.
Available since: 3.0.0
Purple.ContactInfo:id
The protocol specific id for the contact.
Available since: 3.0.0
Purple.ContactInfo:name-for-display
The name that the user interface should display for this contact info.
Available since: 3.0.0
Purple.ContactInfo:permission
The permission level for the contact.
Available since: 3.0.0
Purple.ContactInfo:person
The PurplePerson
that this contact belongs to.
Available since: 3.0.0
Purple.ContactInfo:presence
The PurplePresence
for this contact. This is typically
controlled by the protocol and should only be read by others.
Available since: 3.0.0
Purple.ContactInfo:tags
The PurpleTags
for this contact.
Available since: 3.0.0
Purple.ContactInfo:username
The username for this contact. In rare cases this can change, like when a user changes their “nick” on IRC which is their user name.
Available since: 3.0.0
Signals
Purple.Account::setting-changed
The ::setting-changed signal is emitted whenever an account setting is changed.
Available since: 3.0.0
Signals inherited from GObject (1)
GObject.Object::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.