/** @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 @signaldef conversation-dragging void (*conversation_dragging)(GaimGtkWindow *source, GaimGtkWindow *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)(GaimConversation *conv, struct tm *tm); Emitted to allow plugins to customize the timestamp on a message. @param conv The conversation the message belongs to. @param tm The time to be converted to a string. @return A textual representation of the time, or @c NULL to use a @signaldef displaying-im-msg gboolean (*displaying_im_msg)(GaimAccount *account, const char *who, char **message, GaimConversation *conv, 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)(GaimAccount *account, const char *who, char *message, GaimConversation *conv, 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)(GaimAccount *account, const char *who, char **message, GaimConversation *conv, 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)(GaimAccount *account, const char *who, char *message, GaimConversation *conv, 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)(GaimConversation *conv); Emitted when a window switched from one conversation to another. @param new_conv The now active conversation. // vim: syntax=c tw=75 et