/** @page gtkconv-signals GtkConv Signals @signal conversation-dragging @signal conversation-timestamp @signal displaying-im-msg @signal displaying-chat-msg @signal displayed-chat-msg @signal conversation-switched @signal conversation-hiding @signal conversation-displayed @signaldef conversation-dragging void (*conversation_dragging)(PidginWindow *source, PidginWindow *destination); Emitted when a conversation is being drag and dropped between windows. @param source The window where the conversation is. @param destination The window where the conversation will be moved to. @signaldef conversation-timestamp char *(*conversation_timestamp)(PurpleConversation *conv, time_t when, Emitted to allow plugins to customize the timestamp on a message. @param conv The conversation the message belongs to. @param when The time to be converted to a string. @param show_date Whether the date should be displayed. @return A textual representation of the time, or @c NULL to use a @signaldef displaying-im-msg gboolean (*displaying_im_msg)(PurpleAccount *account, const char *who, char **message, PurpleConversation *conv, PurpleMessageFlags flags); Emitted just before a message is displayed in an IM conversation. @a 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 @c TRUE. Make sure to free @a *message before you replace it! @param account The account. @param who The name of the user. @param message A pointer to the message. @param conv The conversation. @param flags Flags for this message. @return @c TRUE if the message should be canceled, or @c FALSE otherwise. @signaldef displayed-im-msg void (*displayed_im_msg)(PurpleAccount *account, const char *who, char *message, PurpleConversation *conv, PurpleMessageFlags flags); Emitted after a message is displayed in an IM conversation. @param account The account. @param who The name of the user. @param message The message. @param conv The conversation. @param flags Flags for this message. @signaldef displaying-chat-msg gboolean (*displaying_chat_msg)(PurpleAccount *account, const char *who, char **message, PurpleConversation *conv, PurpleMessageFlags flags); Emitted just before a message is displayed in a chat. @a 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 @c TRUE. Make sure to free @a *message before you replace it! @param account The account the message is being displayed and sent on. @param who The name of the user. @param message A pointer to the message that will be displayed and sent. @param conv The conversation the message is being displayed and sent on. @param flags Flags for this message. @return @c TRUE if the message should be canceled, or @c FALSE otherwise. @signaldef displayed-chat-msg void (*displayed_chat_msg)(PurpleAccount *account, const char *who, char *message, PurpleConversation *conv, PurpleMessageFlags flags); Emitted after a message is displayed in a chat conversation. @param account The account the message is being displayed and sent on. @param who The name of the user. @param message A pointer to the message that will be displayed and sent. @param conv The conversation the message is being displayed and sent on. @param flags Flags for this message. @signaldef conversation-switched void (*conversation_switched)(PurpleConversation *conv); Emitted when a window switched from one conversation to another. @param new_conv The now active conversation. @signaldef conversation-hiding void (*conversation_hiding)(PidginConversation *gtkconv); Emitted immediately before an existing conversation is hidden. @param gtkconv The PidginConversation @signaldef conversation-displayed void (*conversation_displayed)(PidginConversation *gtkconv); Emitted right after the Pidgin UI is attached to a new or a hidden conversation. @param gtkconv The PidginConversation // vim: syntax=c.doxygen tw=75 et