Connection Signals

Signals:

See also:
connection.h

signing-on

void (*signing_on)(PurpleConnection *gc);
Description:
Emitted when a connection is about to sign on.
Parameters:
gc The connection that is about to sign on.

signed-on

void (*signed_on)(PurpleConnection *gc);
Description:
Emitted when a connection has signed on.
Parameters:
gc The connection that has signed on.

autojoin

gboolean (*autojoin)(PurpleConnection *gc);
Description:
Emitted when a connection has signed on, after the signed-on signal, to signal UIs to autojoin chats if they wish. UIs should connect to this with PURPLE_SIGNAL_PRIORITY_HIGHEST to allow plugins to block this signal before the UI sees it and then re-emit it later.
Parameters:
gc The connection that has signed on.
Returns:
TRUE if the signal was handled or FALSE otherwise. In practice, the return value is irrelevant, as it really only exists so plugins can block the UI's autojoin.
Since:
2.7.0

signing-off

void (*signing_off)(PurpleConnection *gc);
Description:
Emitted when a connection is about to sign off.
Parameters:
gc The connection that is about to sign off.

signed-off

void (*signed_off)(PurpleConnection *gc);
Description:
Emitted when a connection has signed off.
Parameters:
gc The connection that has signed off.

connection-error

void (*connection_error)(PurpleConnection *gc, PurpleConnectionError err, const gchar *desc)
Description:
Emitted when a connection error occurs, before signed-off.
Parameters:
gc The connection on which the error has occurred
err The error that occurred
desc A description of the error, giving more information.