/** @page account-signals Account Signals @signal account-destroying @signal account-connecting @signal account-setting-info @signal account-status-changed @signal account-actions-changed @signal account-alias-changed @signal account-authorization-requested @signal account-authorization-denied @signal account-authorization-granted @signal account-error-changed @signal account-signed-on @signal account-signed-off @signal account-connection-error @signaldef account-created void (*account_created)(PurpleAccount *account); Emitted when an account is created by calling purple_account_new. @param account The account. @signaldef account-destroying void (*account_destroying)(PurpleAccount *account); Emitted when an account is about to be destroyed. @param account The account. void (*account_added)(PurpleAccount *account); Emitted when an account is added. @param account The account that was added. @signaldef account-connecting void (*account_connecting)(PurpleAccount *account); This is called when an account is in the process of connecting. @param account The account in the process of connecting. @signaldef account-removed void (*account_removed)(PurpleAccount *account); Emitted when an account is removed. @param account The account that was removed. @see purple_accounts_remove @signaldef account-disabled void (*account_disabled)(PurpleAccount *account); Emitted when an account is disabled. @param account The account that was disabled. @signaldef account-enabled void (*account_enabled)(PurpleAccount *account); Emitted when an account is enabled. @param account The account that was enabled. @signaldef account-setting-info void (*account_setting_info)(PurpleAccount *account, const char *new_info); Emitted when a user is about to send his new user info, or @param account The account that the info will be set on. @param new_info The new information to set. @signaldef account-set-info void (*account_set_info)(PurpleAccount *account, const char *new_info); Emitted when a user sent his new user info, or profile, to the server. @param account The account that the info was set on. @param new_info The new information set. @signaldef account-status-changed void (*account_status_changed)(PurpleAccount *account, PurpleStatus *old, PurpleStatus *new); Emitted when the status of an account changes (after the change). @param account The account that changed status. @param old The status before change. @param new The status after change. @signaldef account-actions-changed void (*account_actions_changed)(PurpleAccount *account); Emitted when the account actions are changed after initial connection. @param account The account whose actions changed. @signaldef account-alias-changed void (*account_alias_changed)(PurpleAccount *account, const char *old); Emitted when the alias of an account changes (after the change). @param account The account for which the alias was changed. @param old The alias before change. @signaldef account-authorization-requested int (*account_authorization_requested)(PurpleAccount *account, const char *user, const char *message, char **response); Emitted when a user requests authorization. @param account The account. @param user The name of the user requesting authorization. @param message The authorization request message. @param response The message to send in the response. @return PURPLE_ACCOUNT_RESPONSE_IGNORE to silently ignore the request, PURPLE_ACCOUNT_RESPONSE_DENY to block the request (the sender might get informed), PURPLE_ACCOUNT_RESPONSE_ACCEPT if the request should be granted. If PURPLE_ACCOUNT_RESPONSE_PASS is returned, then the user will be prompted with the request. @signaldef account-authorization-denied void (*account_authorization_denied)(PurpleAccount *account, const char *user, const char *message); Emitted when the authorization request for a buddy is denied. @param account The account. @param user The name of the user requesting authorization. @param message The message to tell the buddy who was denied. @signaldef account-authorization-granted void (*account_authorization_granted)(PurpleAccount *account, const char *user, const char *message); Emitted when the authorization request for a buddy is granted. @param account The account. @param user The name of the user requesting authorization. @param message The message to tell the buddy who was granted authorization. @signaldef account-error-changed void (*account_error_changed)(PurpleAccount *account, const PurpleConnectionErrorInfo *old_error, const PurpleConnectionErrorInfo *current_error); Emitted when @a account's error changes. You should not call purple_account_clear_current_error() while this signal is being emitted. @param account The account whose error has changed. @param old_error The account's previous error, or @c NULL if it had no error. After this signal is emitted, @a old_error is not guaranteed to be a valid pointer. @param new_error The account's new error, or @c NULL if it has no error. If not @c NULL, @a new_error will remain a valid until pointer just after the next time this signal is emitted @see purple_account_get_current_error() @signaldef account-signed-on void (*signed_on)(PurpleAccount *account); Emitted when an account has signed on. @param account The account that has signed on. @signaldef account-signed-off void (*signed_off)(PurpleAccount *account); Emitted when an account has signed off. @param account The account that has signed off. @signaldef account-connection-error void (*connection_error)(PurpleAccount *gc, PurpleConnectionError err, const gchar *desc) Emitted when a connection error occurs, before @ref signed-off. @param account The account on which the error has occurred @param err The error that occurred @param desc A description of the error, giving more information. // vim: syntax=c.doxygen tw=75 et