Class
PurpleAccount
since: 2.0
Description [src]
final class Purple.Account : GObject.Object {
/* 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.
Available since: 2.0
Instance methods
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.
since: 3.0
purple_account_get_error
Get the error that caused the account to be disconnected, or NULL
if the
account is happily connected or disconnected without an error.
since: 3.0
purple_account_get_remember_password
Returns whether or not this account should save its password.
since: 2.0
purple_account_is_disconnecting
Indicates if the account is currently being disconnected.
since: 3.0
purple_account_request_close_with_account
Close account requests registered for the given PurpleAccount.
since: 2.0
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.
since: 2.0
purple_account_set_error
Sets the error of account
to info
. Note that setting this won’t disconnect
the account. This is intended to be called by libpurple when there is a
connection failure, when invalid settings are entered in an account editor,
or similar situations.
since: 3.0
purple_account_set_remember_password
Sets whether or not this account should save its password.
since: 2.0
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.
since: 3.0
Properties
Purple.Account:buddy-icon-path
The path to the file to use as the avatar for this account.
since: 3.0
Purple.Account:connection
The PurpleConnection
object for this account. This will be NULL
when
the account is offline.
since: 3.0
Purple.Account:enabled
Whether or not this account should track the user’s global status.
since: 3.0
Purple.Account:error
The GError
of the account. This is set when an account enters
an error state and is automatically cleared when a connection attempt is made.
since: 3.0
Purple.Account:remember-password
Whether or not the password for this account should be stored in the
configured PurpleCredentialProvider
.
since: 3.0
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.
since: 3.0
Signals
Purple.Account::connected
This is emitted when the PurpleAccount:connection
‘s
PurpleConnection:state
has changed to
PURPLE_CONNECTION_STATE_CONNECTED
.
since: 3.0
Purple.Account::disconnected
This is emitted when the PurpleAccount:connection
‘s
PurpleConnection:state
has changed to
PURPLE_CONNECTION_STATE_DISCONNECTED
.
since: 3.0
Purple.Account::setting-changed
The ::setting-changed signal is emitted whenever an account setting is changed.
since: 3.0
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.