pidgin: Connection Signals

pidgin 2.14.4

Loading...
Searching...
No Matches
Connection Signals

Signals:

- signing-on
- signed-on
- autojoin
- signing-off
- signed-off
- connection-error

See also
  connection.h

# signing-on

void (*signing_on)(PurpleConnection *gc);
_PurpleConnection
Definition: connection.h:246

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)
PurpleConnectionError
PurpleConnectionError
Possible errors that can cause a connection to be closed.
Definition: connection.h:66

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.