Title: Conversation Signals
Slug: conversation-signals
user_function(PurpleAccount *account, PurpleConversation *conv, PurpleMessageFlags flags, Emitted just before a message is displayed in an IM conversation.
`message` is
a pointer to a string, so the plugin can replace the message that will be
displayed. This can also be used to cancel displaying a message by returning
> **NOTE:** Make sure to free `*message` before you replace it! : A pointer to the message.
: Flags for this message.
: User data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
user_function(PurpleAccount *account, PurpleConversation *conv, PurpleMessageFlags flags, Emitted after a message is displayed in an IM conversation.
: Flags for this message.
: User data set when the signal handler was connected.
user_function(PurpleAccount *account, PurpleConversation *conv, PurpleMessageFlags flags, Emitted just before a message is displayed in a chat.
`message` is a pointer to
a string, so the plugin can replace the message that will be displayed. This
can also be used to cancel displaying a message by returning
`TRUE`.
> **NOTE:** Make sure to free `*message` before you replace it! : The account the message is being displayed and sent on.
: A pointer to the message that will be displayed and sent.
: The conversation the message is being displayed and sent on.
: Flags for this message.
: User data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
user_function(PurpleAccount *account, PurpleConversation *conv, PurpleMessageFlags flags, Emitted after a message is displayed in a chat conversation.
: The account the message is being displayed and sent on.
: A pointer to the message that will be displayed and sent.
: The conversation the message is being displayed and sent on.
: Flags for this message.
: User data set when the signal handler was connected.
### conversation-switched void user_function(PurpleConversation *conv, gpointer user_data); Emitted when a window switched from one conversation to another.
: The now active conversation.
: User data set when the signal handler was connected.
### conversation-displayed void user_function(PidginConversation *gtkconv, gpointer user_data); Emitted right after the Pidgin UI is attached to a new conversation.
: The PidginConversation.
: User data set when the signal handler was connected.