#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) |
Any UI representing a conversation must assign a filled-out PurpleConversationUiOps structure to the PurpleConversation.
Definition at line 157 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().) |
void(* _PurpleConversationUiOps::chat_remove_users)(PurpleConversation *conv, GList *users) |
Remove users from a chat.
users | A GList of const char * s. |
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. |
void(* _PurpleConversationUiOps::chat_update_user)(PurpleConversation *conv, const char *user) |
void(* _PurpleConversationUiOps::destroy_conversation)(PurpleConversation *conv) |
Called just before conv is freed.
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().
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.
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.
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.