comparison doc/conversation-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 <[e-mail]>

12638:7a2a2ca48703

/** @page conversation-signals Conversation Signals

 @signals
  @signal writing-im-msg
  @signal wrote-im-msg
  @signal displaying-im-msg
  @signal displayed-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal receiving-im-msg
  @signal received-im-msg
  @signal writing-chat-msg
  @signal wrote-chat-msg
  @signal displaying-chat-msg
  @signal displayed-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal receiving-chat-msg
  @signal received-chat-msg
  @signal conversation-switching
  @signal conversation-switched
  @signal conversation-created
  @signal conversation-updated
  @signal deleting-conversation
  @signal buddy-typing
  @signal buddy-typing-stopped

void (*wrote_im_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   and finally sent-im-msg.
  @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.
 @endsignaldef

 @signaldef displaying-im-msg
  @signalproto
gboolean (*displaying_im_msg)(GaimAccount *account, GaimConversation *conv, char **message);
  @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.
  @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);
  @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.
 @endsignaldef

void (*wrote_chat_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   and finally sent-im-msg.
  @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.
 @endsignaldef

 @signaldef displaying-chat-msg
  @signalproto
gboolean (*displaying_chat_msg)(GaimAccount *account, GaimConversation *conv, char **message);
  @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.
  @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);
  @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.
 @endsignaldef

  @param account The account the message was received on.
  @param sender  The username of the sender.
  @param message The message that was sent.
  @param conv    The chat conversation.
  @param flags   The chat message flags.
 @endsignaldef

 @signaldef conversation-switching
  @signalproto
void (*conversation_switching)(GaimConversation *old_conv,
                               GaimConversation *new_conv);
  @endsignalproto
  @signaldesc
   Emitted when a window is about to switch from one conversation to
   another.
  @param old_conv The old active conversation.
  @param new_conv The soon-to-be active conversation
 @endsignaldef

 @signaldef conversation-switched
  @signalproto
void (*conversation_switched)(GaimConversation *old_conv,
                              GaimConversation *new_conv);
  @endsignalproto
  @signaldesc
   Emitted when a window switched from one conversation to another.
  @param old_conv The old active conversation.
  @param new_conv The now active conversation.
 @endsignaldef

 @signaldef conversation-created
  @signalproto
void (*conversation_created)(GaimConversation *conv);

12639:366326fa9cb4

/** @page conversation-signals Conversation Signals

 @signals
  @signal writing-im-msg
  @signal wrote-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal receiving-im-msg
  @signal received-im-msg
  @signal writing-chat-msg
  @signal wrote-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal receiving-chat-msg
  @signal received-chat-msg
  @signal conversation-created
  @signal conversation-updated
  @signal deleting-conversation
  @signal buddy-typing
  @signal buddy-typing-stopped

void (*wrote_im_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, sending-im-msg, and finally sent-im-msg.
  @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.
 @endsignaldef

void (*wrote_chat_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-chat-msg, wrote-chat-msg, sending-chat-msg, and finally
   sent-chat-msg.
  @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.
 @endsignaldef

  @param account The account the message was received on.
  @param sender  The username of the sender.
  @param message The message that was sent.
  @param conv    The chat conversation.
  @param flags   The chat message flags.
 @endsignaldef

 @signaldef conversation-created
  @signalproto
void (*conversation_created)(GaimConversation *conv);