Conversation operations and events. More...
#include <conversation.h>
Data Fields | |
| void(* | create_conversation )(PurpleConversation *conv) |
| Called when conv is created (but before the conversation-created signal is emitted). | |
| void(* | destroy_conversation )(PurpleConversation *conv) |
| Called just before conv is freed. | |
| void(* | write_chat )(PurpleConversation *conv, const char *who, const char *message, PurpleMessageFlags flags, time_t mtime) |
| Write a message to a chat. | |
| void(* | write_im )(PurpleConversation *conv, const char *who, const char *message, PurpleMessageFlags flags, time_t mtime) |
| Write a message to an IM conversation. | |
| void(* | write_conv )(PurpleConversation *conv, const char *name, const char *alias, const char *message, PurpleMessageFlags flags, time_t mtime) |
| Write a message to a conversation. | |
| void(* | chat_add_users )(PurpleConversation *conv, GList *cbuddies, gboolean new_arrivals) |
| Add cbuddies to a chat. | |
| void(* | chat_rename_user )(PurpleConversation *conv, const char *old_name, const char *new_name, const char *new_alias) |
| Rename the user in this chat named old_name to new_name. | |
| void(* | chat_remove_users )(PurpleConversation *conv, GList *users) |
| Remove users from a chat. | |
| void(* | chat_update_user )(PurpleConversation *conv, const char *user) |
| Called when a user's flags are changed. | |
| void(* | present )(PurpleConversation *conv) |
| Present this conversation to the user; for example, by displaying the IM dialog. | |
| gboolean(* | has_focus )(PurpleConversation *conv) |
If this UI has a concept of focus (as in a windowing system) and this conversation has the focus, return TRUE; otherwise, return FALSE. | |
| gboolean(* | custom_smiley_add )(PurpleConversation *conv, const char *smile, gboolean remote) |
| void(* | custom_smiley_write )(PurpleConversation *conv, const char *smile, const guchar *data, gsize size) |
| void(* | custom_smiley_close )(PurpleConversation *conv, const char *smile) |
| void(* | send_confirm )(PurpleConversation *conv, const char *message) |
| Prompt the user for confirmation to send message. | |
| void(* | _purple_reserved1 )(void) |
| void(* | _purple_reserved2 )(void) |
| void(* | _purple_reserved3 )(void) |
| void(* | _purple_reserved4 )(void) |
Conversation operations and events.
Any UI representing a conversation must assign a filled-out PurpleConversationUiOps structure to the PurpleConversation.
Definition at line 158 of file conversation.h.
| void(* _PurpleConversationUiOps::chat_add_users)(PurpleConversation *conv, GList *cbuddies, gboolean new_arrivals) |
Add cbuddies to a chat.
| cbuddies | A GList of PurpleConvChatBuddy structs. |
| new_arrivals | Whether join notices should be shown. (Join notices are actually written to the conversation by purple_conv_chat_add_users().) |
Definition at line 202 of file conversation.h.
| void(* _PurpleConversationUiOps::chat_remove_users)(PurpleConversation *conv, GList *users) |
Remove users from a chat.
| users | A GList of const char *s. |
Definition at line 216 of file conversation.h.
| void(* _PurpleConversationUiOps::chat_rename_user)(PurpleConversation *conv, const char *old_name, const char *new_name, const char *new_alias) |
Rename the user in this chat named old_name to new_name.
(The rename message is written to the conversation by libpurple.)
| new_alias | new_name's new alias, if they have one. |
Definition at line 210 of file conversation.h.
| void(* _PurpleConversationUiOps::chat_update_user)(PurpleConversation *conv, const char *user) |
Called when a user's flags are changed.
Definition at line 220 of file conversation.h.
| void(* _PurpleConversationUiOps::destroy_conversation)(PurpleConversation *conv) |
Called just before conv is freed.
Definition at line 166 of file conversation.h.
| void(* _PurpleConversationUiOps::send_confirm)(PurpleConversation *conv, const char *message) |
Prompt the user for confirmation to send message.
This function should arrange for the message to be sent if the user accepts. If this field is NULL, libpurple will fall back to using purple_request_action().
Definition at line 244 of file conversation.h.
| void(* _PurpleConversationUiOps::write_chat)(PurpleConversation *conv, const char *who, const char *message, PurpleMessageFlags flags, time_t mtime) |
Write a message to a chat.
If this field is NULL, libpurple will fall back to using write_conv.
Definition at line 171 of file conversation.h.
| void(* _PurpleConversationUiOps::write_conv)(PurpleConversation *conv, const char *name, const char *alias, const char *message, PurpleMessageFlags flags, time_t mtime) |
Write a message to a conversation.
This is used rather than the chat- or im-specific ops for errors, system messages (such as "x is now know as y"), and as the fallback if write_im and write_chat are not implemented. It should be implemented, or the UI will miss conversation error messages and your users will hate you.
Definition at line 189 of file conversation.h.
| void(* _PurpleConversationUiOps::write_im)(PurpleConversation *conv, const char *who, const char *message, PurpleMessageFlags flags, time_t mtime) |
Write a message to an IM conversation.
If this field is NULL, libpurple will fall back to using write_conv.
Definition at line 178 of file conversation.h.