Mercurial > pidgin
view doc/gtkconv-signals.dox @ 12639:366326fa9cb4
[gaim-migrate @ 14975]
SF Patch #1323534 from Sadrul
"There is a documented signal `conversation-switched',
which never gets emitted. This patch emits this signal
when a conversation is switched. This signal can be
used by plugins that may want to deal with menu-items /
menu-tray items etc."
"The conversation-switched signals is moved to gtkconv,
-switching signal is removed. Changelog.API and doc/.dox
files are updated. I have included the changes in
displaying-signals in the dox-files as well."
Also, I added a cast to the code from my last commit to suppress a warning. I wish C knew about object oriented inheritance.
committer: Tailor Script <tailor@pidgin.im>
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Fri, 23 Dec 2005 05:13:52 +0000 |
parents | 5bc3d67ceb24 |
children | a1e241dd50b6 |
line wrap: on
line source
/** @page gtkconv-signals GtkConv Signals @signals @signal conversation-dragging @signal displaying-im-msg @signal displayed-im-msg @signal displaying-chat-msg @signal displayed-chat-msg @signal conversation-switched @endsignals <hr> @signaldef conversation-dragging @signalproto void (*conversation_dragging)(GaimGtkWindow *source, GaimGtkWindow *destination); @endsignalproto @signaldesc 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. @endsignaldef @signaldef displaying-im-msg @signalproto gboolean (*displaying_im_msg)(GaimAccount *account, GaimConversation *conv, char **message, GaimMessageFlags flags); @endsignalproto @signaldesc 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. @note Make sure to free @a *message before you replace it! @param account The account the message is being displayed on. @param conv The conversation the message is being displayed on. @param message A pointer to the message that will be displayed. @param flags The message flags. @return @c TRUE if the message should be canceled, or @c FALSE otherwise. @endsignaldef @signaldef displayed-im-msg @signalproto void (*displayed_im_msg)(GaimAccount *account, GaimConversation *conv, const char *message, GaimMessageFlags flags); @endsignalproto @signaldesc Emitted after a message is displayed in an IM conversation. @param account The account the message was displayed on. @param conv The conversation the message was displayed on. @param message The message that was displayed. @param flags The message flags. @endsignaldef @signaldef displaying-chat-msg @signalproto gboolean (*displaying_chat_msg)(GaimAccount *account, GaimConversation *conv, char **message, GaimMessageFlags flags); @endsignalproto @signaldesc 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. @note Make sure to free @a *message before you replace it! @param account The account the message is being displayed on. @param conv The conversation the message is being displayed on. @param message A pointer to the message that will be displayed. @param flags The message flags. @return @c TRUE if the message should be canceled, or @c FALSE otherwise. @endsignaldef @signaldef displayed-chat-msg @signalproto void (*displayed_chat_msg)(GaimAccount *account, GaimConversation *conv, const char *message, GaimMessageFlags flags); @endsignalproto @signaldesc Emitted after a message is displayed in a chat conversation. @param account The account the message was displayed on. @param conv The conversation the message was displayed on. @param message The message that was displayed. @param flags The message flags. @endsignaldef @signaldef conversation-switched @signalproto void (*conversation_switched)(GaimConversation *conv); @endsignalproto @signaldesc Emitted when a window switched from one conversation to another. @param new_conv The now active conversation. @endsignaldef */ // vim: syntax=c tw=75 et