comparison src/conversation.h @ 10246:a66cf83552dc

[gaim-migrate @ 11386] I changed gaim_find_conversation and gaim_find_conversation_with_account The first parameter is now one of GAIM_CONV_IM, GAIM_CONV_CHAT or GAIM_CONV_ANY. Unfortunately, this changes a bajillion files. Please look over this and make sure I use the correct type everywhere. Especially in Novell and MSN, and somewhat in SILC. committer: Tailor Script <tailor@pidgin.im>
author Mark Doliner <mark@kingant.net>
date Tue, 23 Nov 2004 06:14:15 +0000
parents 50c1724d5e59
children bbf738a0ce7b
comparison
equal deleted inserted replaced
10245:c143a3fac58d 10246:a66cf83552dc
45 typedef enum 45 typedef enum
46 { 46 {
47 GAIM_CONV_UNKNOWN = 0, /**< Unknown conversation type. */ 47 GAIM_CONV_UNKNOWN = 0, /**< Unknown conversation type. */
48 GAIM_CONV_IM, /**< Instant Message. */ 48 GAIM_CONV_IM, /**< Instant Message. */
49 GAIM_CONV_CHAT, /**< Chat room. */ 49 GAIM_CONV_CHAT, /**< Chat room. */
50 GAIM_CONV_MISC /**< A misc. conversation. */ 50 GAIM_CONV_MISC, /**< A misc. conversation. */
51 GAIM_CONV_ANY /**< Any type of conversation. */
51 52
52 } GaimConversationType; 53 } GaimConversationType;
53 54
54 /** 55 /**
55 * Unseen text states. 56 * Unseen text states.
781 * @return A GList of all chats. 782 * @return A GList of all chats.
782 */ 783 */
783 GList *gaim_get_chats(void); 784 GList *gaim_get_chats(void);
784 785
785 /** 786 /**
786 * Finds the conversation with the specified name. 787 * Finds the conversation with the specified type and name. In most
787 * 788 * cases you should use gaim_find_conversation_with_account() instead
789 * of this.
790 *
791 * @param type The type of the conversation.
788 * @param name The name of the conversation. 792 * @param name The name of the conversation.
789 * 793 *
790 * @return The conversation if found, or @c NULL otherwise. 794 * @return The conversation if found, or @c NULL otherwise.
791 */ 795 */
792 GaimConversation *gaim_find_conversation(const char *name); 796 GaimConversation *gaim_find_conversation(GaimConversationType type,
793 797 const char *name);
794 /** 798
795 * Finds a conversation with the specified name and user. 799 /**
796 * 800 * Finds a conversation with the specified type, name, and Gaim account.
801 *
802 * @param type The type of the conversation.
797 * @param name The name of the conversation. 803 * @param name The name of the conversation.
798 * @param account The gaim_account associated with the conversation. 804 * @param account The gaim_account associated with the conversation.
799 * 805 *
800 * @return The conversation if found, or @c NULL otherwise. 806 * @return The conversation if found, or @c NULL otherwise.
801 */ 807 */
802 GaimConversation *gaim_find_conversation_with_account( 808 GaimConversation *gaim_find_conversation_with_account(
803 const char *name, const GaimAccount *account); 809 GaimConversationType type, const char *name,
810 const GaimAccount *account);
804 811
805 /** 812 /**
806 * Writes to a conversation window. 813 * Writes to a conversation window.
807 * 814 *
808 * This function should not be used to write IM or chat messages. Use 815 * This function should not be used to write IM or chat messages. Use