libaccounts Reference Manual | ||||
---|---|---|---|---|
AccountItem; gboolean account_item_set_enabled (AccountItem *account, gboolean enabled, GError **error); AccountPlugin* account_item_get_plugin (AccountItem *account); AccountService* account_item_get_service (AccountItem *account);
"avatar" GdkPixbuf* : Read / Write "connected" gboolean : Read "display-name" gchar* : Read / Write "enabled" gboolean : Read "name" gchar* : Read / Write "service" AccountService* : Read / Write / Construct Only "service-icon" GdkPixbuf* : Read "service-name" gchar* : Read "supports-avatar" gboolean : Read / Write
An AccountItem is an object which represents an account. It provides a method for enabling/disabling the account and methods for retrieving the AccountService and AccountPlugin it belongs to; the account data are exposed as properties.
Account plugins must subclass of AccountItem and implement the
account_item_set_enabled()
method.
gboolean account_item_set_enabled (AccountItem *account, gboolean enabled, GError **error);
Enables or disables account
.
This is a virtual method that must be implemented by account plugins by
subclassing AccountItem. The method's task is to enable/disable the
account; to do so, set the AccountItem.enabled member to the desired value
and call g_object_notify()
on the "enabled" property.
In versions up to 3.73, the "enabled" property was set automatically, consistently with the method's return value.
account : |
the AccountItem. |
enabled : |
whether to enable or disable the account. |
error : |
a GError for error reporting, or NULL .
|
Returns : | TRUE if success, FALSE on error.
|
AccountPlugin* account_item_get_plugin (AccountItem *account);
Gets the plugin which manages this account item.
account : |
the AccountItem. |
Returns : | a AccountPlugin; its reference count is not incremented. |
AccountService* account_item_get_service (AccountItem *account);
Gets the service which this account item provides.
account : |
the AccountItem. |
Returns : | a AccountService; its reference count is not incremented. |