comparison libpurple/conversation.h @ 31822:6c660dc7cb6a

Moved the conversation attributes API and the IRC periodic WHO updates to i.p.p.next.minor, where they belong. applied changes from 3de680fff7ddd1b00149657afb7f6cd833000a90 through 7ee5e1d431651ed2b1a54bc942d63f35580af55c applied changes from e7c103fdfbc59bb2ca41a3c8813c4ff2847a673f through 22937ab220c41cd0c4a3f9e21e3db687db80da75 applied changes from 22937ab220c41cd0c4a3f9e21e3db687db80da75 through cba010d1c097d4e6599f08276ed9d894710c1074 applied changes from a694289accbec14c593b3636ef1f626fd8279805 through 8a43e3ddd7adacb208afe2d7ee3ea983c95901be
author Evan Schoenberg <evan.s@dreskin.net>
date Mon, 21 Feb 2011 23:08:47 +0000
parents dcd52d2b1b97
children d72d728226dc
comparison
equal deleted inserted replaced
31821:17a4b32f4d46 31822:6c660dc7cb6a
137 PURPLE_CBFLAGS_NONE = 0x0000, /**< No flags */ 137 PURPLE_CBFLAGS_NONE = 0x0000, /**< No flags */
138 PURPLE_CBFLAGS_VOICE = 0x0001, /**< Voiced user or "Participant" */ 138 PURPLE_CBFLAGS_VOICE = 0x0001, /**< Voiced user or "Participant" */
139 PURPLE_CBFLAGS_HALFOP = 0x0002, /**< Half-op */ 139 PURPLE_CBFLAGS_HALFOP = 0x0002, /**< Half-op */
140 PURPLE_CBFLAGS_OP = 0x0004, /**< Channel Op or Moderator */ 140 PURPLE_CBFLAGS_OP = 0x0004, /**< Channel Op or Moderator */
141 PURPLE_CBFLAGS_FOUNDER = 0x0008, /**< Channel Founder */ 141 PURPLE_CBFLAGS_FOUNDER = 0x0008, /**< Channel Founder */
142 PURPLE_CBFLAGS_TYPING = 0x0010 /**< Currently typing */ 142 PURPLE_CBFLAGS_TYPING = 0x0010, /**< Currently typing */
143 PURPLE_CBFLAGS_AWAY = 0x0020 /**< Currently away. @since 2.8.0 */
143 144
144 } PurpleConvChatBuddyFlags; 145 } PurpleConvChatBuddyFlags;
145 146
146 #include "account.h" 147 #include "account.h"
147 #include "buddyicon.h" 148 #include "buddyicon.h"
298 * buddy list; @a FALSE otherwise. 299 * buddy list; @a FALSE otherwise.
299 */ 300 */
300 PurpleConvChatBuddyFlags flags; /**< A bitwise OR of flags for this participant, 301 PurpleConvChatBuddyFlags flags; /**< A bitwise OR of flags for this participant,
301 * such as whether they are a channel operator. 302 * such as whether they are a channel operator.
302 */ 303 */
304 GHashTable *attributes; /**< A hash table of attributes about the user, such as
305 * real name, user@host, etc.
306 */
303 }; 307 };
304 308
305 /** 309 /**
306 * Description of a conversation message 310 * Description of a conversation message
307 * 311 *
509 * 513 *
510 * @return The conversation's name. If the conversation is an IM with a PurpleBuddy, 514 * @return The conversation's name. If the conversation is an IM with a PurpleBuddy,
511 * then it's the name of the PurpleBuddy. 515 * then it's the name of the PurpleBuddy.
512 */ 516 */
513 const char *purple_conversation_get_name(const PurpleConversation *conv); 517 const char *purple_conversation_get_name(const PurpleConversation *conv);
518
519 /**
520 * Get an attribute of a chat buddy
521 *
522 * @param cb The chat buddy.
523 * @param key The key of the attribute.
524 *
525 * @return The value of the attribute key.
526 */
527 const char *purple_conv_chat_cb_get_attribute(PurpleConvChatBuddy *cb, const char *key);
528
529 /**
530 * Get the keys of all atributes of a chat buddy
531 *
532 * @param cb The chat buddy.
533 *
534 * @return A list of the attributes of a chat buddy.
535 */
536 GList *purple_conv_chat_cb_get_attribute_keys(PurpleConvChatBuddy *cb);
537
538 /**
539 * Set an attribute of a chat buddy
540 *
541 * @param chat The chat.
542 * @param cb The chat buddy.
543 * @param key The key of the attribute.
544 * @param value The value of the attribute.
545 */
546 void purple_conv_chat_cb_set_attribute(PurpleConvChat *chat, PurpleConvChatBuddy *cb, const char *key, const char *value);
547
548 /**
549 * Set attributes of a chat buddy
550 *
551 * @param chat The chat.
552 * @param cb The chat buddy.
553 * @param keys A GList of the keys.
554 * @param values A GList of the values.
555 */
556 void
557 purple_conv_chat_cb_set_attributes(PurpleConvChat *chat, PurpleConvChatBuddy *cb, GList *keys, GList *values);
514 558
515 /** 559 /**
516 * Enables or disables logging for this conversation. 560 * Enables or disables logging for this conversation.
517 * 561 *
518 * @param conv The conversation. 562 * @param conv The conversation.