comparison src/conversation.h @ 4876:9567b13d0e98

[gaim-migrate @ 5206] Added gaim_conversation_(set|get)_plugin_data(), which sets and gets plugin-specific data. It just wraps a hashtable, and it will be replaced sometime down the road if we move to an object framework. However, the function will still exist as a wrapper around g_object_(set|get)_data(). I've said too much. committer: Tailor Script <[e-mail]>

4875:26837f462a66

	} u;

	struct gaim_conversation_ui_ops *ui_ops; /**< UI-specific operations. */
	void *ui_data;                           /**< UI-specific data.       */
};

typedef void (*gaim_conv_placement_fnc)(struct gaim_conversation *);

/**************************************************************************/

 */
struct gaim_chat *gaim_conversation_get_chat_data(
		const struct gaim_conversation *conv);

#define GAIM_CHAT(c) (gaim_conversation_get_chat_data(c))

/**
 * Returns a list of all conversations.
 *
 * This list includes both IMs and chats.

4876:9567b13d0e98

	} u;

	struct gaim_conversation_ui_ops *ui_ops; /**< UI-specific operations. */
	void *ui_data;                           /**< UI-specific data.       */

	GHashTable *plugin_data;                 /**< Plugin-specific data.   */
};

typedef void (*gaim_conv_placement_fnc)(struct gaim_conversation *);

/**************************************************************************/

 */
struct gaim_chat *gaim_conversation_get_chat_data(
		const struct gaim_conversation *conv);

#define GAIM_CHAT(c) (gaim_conversation_get_chat_data(c))

/**
 * Sets a conversation's plugin-specific data.
 * 
 * To minimize key conflicts, the key should be in the form of
 * @c pluginname/keyname.
 *
 * @param conv The conversation.
 * @param key  The unique key.
 * @param data The data to assign.
 */
void gaim_conversation_set_plugin_data(struct gaim_conversation *conv,
									   const char *key, gpointer data);

/**
 * Returns a conversation's plugin-specific data.
 *
 * @param conv The conversation.
 * @param key  The unqiue key.
 *
 * @return The data associated with the key.
 */
gpointer gaim_conversation_get_plugin_data(struct gaim_conversation *conv,
										   const char *key);

/**
 * Returns a list of all conversations.
 *
 * This list includes both IMs and chats.