comparison libpurple/blist.h @ 29755:a3e29e210b2e

propagate from branch 'im.pidgin.pidgin' (head 5e48191adf93863395ea1bc8d7efdc62d54c079d) to branch 'im.pidgin.pidgin.next.minor' (head 6df56a1ab70195e20ac3019502e8bf94eeb4e59a)
author Paul Aurich <paul@darkrain42.org>
date Thu, 11 Feb 2010 20:14:51 +0000
parents e26af064fe8c
children 521cb9430f22
comparison
equal deleted inserted replaced
29424:4e93d6d57067 29755:a3e29e210b2e
106 */ 106 */
107 #define PURPLE_CHAT(obj) ((PurpleChat *)(obj)) 107 #define PURPLE_CHAT(obj) ((PurpleChat *)(obj))
108 108
109 #include "account.h" 109 #include "account.h"
110 #include "buddyicon.h" 110 #include "buddyicon.h"
111 #include "media.h"
111 #include "status.h" 112 #include "status.h"
112 113
113 /**************************************************************************/ 114 /**************************************************************************/
114 /* Data Structures */ 115 /* Data Structures */
115 /**************************************************************************/ 116 /**************************************************************************/
141 char *server_alias; /**< The server-specified alias of the buddy. (i.e. MSN "Friendly Names") */ 142 char *server_alias; /**< The server-specified alias of the buddy. (i.e. MSN "Friendly Names") */
142 void *proto_data; /**< This allows the prpl to associate whatever data it wants with a buddy */ 143 void *proto_data; /**< This allows the prpl to associate whatever data it wants with a buddy */
143 PurpleBuddyIcon *icon; /**< The buddy icon. */ 144 PurpleBuddyIcon *icon; /**< The buddy icon. */
144 PurpleAccount *account; /**< the account this buddy belongs to */ 145 PurpleAccount *account; /**< the account this buddy belongs to */
145 PurplePresence *presence; 146 PurplePresence *presence;
147 PurpleMediaCaps media_caps; /**< The media capabilities of the buddy. */
146 }; 148 };
147 149
148 /** 150 /**
149 * A contact. This contains everything Purple will ever need to know about a contact. 151 * A contact. This contains everything Purple will ever need to know about a contact.
150 */ 152 */
655 * @return The buddy's presence. 657 * @return The buddy's presence.
656 */ 658 */
657 PurplePresence *purple_buddy_get_presence(const PurpleBuddy *buddy); 659 PurplePresence *purple_buddy_get_presence(const PurpleBuddy *buddy);
658 660
659 /** 661 /**
662 * Gets the media caps from a buddy.
663 *
664 * @param buddy The buddy.
665 * @return The media caps.
666 *
667 * @since 2.7.0
668 */
669 PurpleMediaCaps purple_buddy_get_media_caps(const PurpleBuddy *buddy);
670
671 /**
672 * Sets the media caps for a buddy.
673 *
674 * @param buddy The PurpleBuddy.
675 * @param media_caps The PurpleMediaCaps.
676 */
677 void purple_buddy_set_media_caps(PurpleBuddy *buddy, PurpleMediaCaps media_caps);
678
679 /**
660 * Adds a new buddy to the buddy list. 680 * Adds a new buddy to the buddy list.
661 * 681 *
662 * The buddy will be inserted right after node or prepended to the 682 * The buddy will be inserted right after node or prepended to the
663 * group if node is NULL. If both are NULL, the buddy will be added to 683 * group if node is NULL. If both are NULL, the buddy will be added to
664 * the "Buddies" group. 684 * the "Buddies" group.
713 * @param contact The contact to destroy 733 * @param contact The contact to destroy
714 */ 734 */
715 void purple_contact_destroy(PurpleContact *contact); 735 void purple_contact_destroy(PurpleContact *contact);
716 736
717 /** 737 /**
738 * Gets the PurpleGroup from a PurpleContact
739 *
740 * @param contact The contact
741 * @return The group
742 *
743 * @since 2.7.0
744 */
745 PurpleGroup *purple_contact_get_group(const PurpleContact *contact);
746
747 /**
718 * Adds a new contact to the buddy list. 748 * Adds a new contact to the buddy list.
719 * 749 *
720 * The new contact will be inserted after insert or prepended to the list if 750 * The new contact will be inserted after insert or prepended to the list if
721 * node is NULL. 751 * node is NULL.
722 * 752 *