comparison src/blist.h @ 12919:248b8b39c671

[gaim-migrate @ 15272] Replace GaimBlistNodeAction with the more generic GaimMenuAction, this is in preparation for letting the chat room user list have extensible menus like the blist entries do. (I know it's not exactly the prettiest, and the callback isn't exactly type-safe, when we eventually gobjectify everything we can get some safety back by using (GObject, gpointer) but that's for later.) I'm planning to look into merging GaimPluginActions into GaimMenuActions as well. committer: Tailor Script <[e-mail]>

12918:a05fbd9dcc31

#include <glib.h>

typedef struct _GaimBuddyList GaimBuddyList;
typedef struct _GaimBlistUiOps GaimBlistUiOps;
typedef struct _GaimBlistNode GaimBlistNode;

typedef struct _GaimBlistNodeAction GaimBlistNodeAction;

typedef struct _GaimChat GaimChat;
typedef struct _GaimGroup GaimGroup;
typedef struct _GaimContact GaimContact;
typedef struct _GaimBuddy GaimBuddy;

	void (*request_add_chat)(GaimAccount *account, GaimGroup *group,
							 const char *alias, const char *name);
	void (*request_add_group)(void);
};


struct _GaimBlistNodeAction {
	char *label;
	void (*callback)(GaimBlistNode *, gpointer);
	gpointer data;
	GList *children;
};


#ifdef __cplusplus
extern "C" {
#endif

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

 */
GaimBlistNodeFlags gaim_blist_node_get_flags(GaimBlistNode *node);

/*@}*/


/**
 * Retrieves the extended menu items for a buddy list node.
 * @param n The blist node for which to obtain the extended menu items.
 * @return  A list of GaimBlistNodeAction items, as harvested by the
 *          blist-node-extended-menu signal.
 */
GList *gaim_blist_node_get_extended_menu(GaimBlistNode *n);


/**
 * Creates a new GaimBlistNodeAction.
 * @param label         The text label to display for this action.
 * @param callback      The function to be called when the action is used on
 *                      a selected GaimBlistNode.
 * @param data          Additional data, to be passed to the callback
 * @param children      A GList of GaimBlistNodeActions to be added as a
 *                      submenu of the action.
 * @return              The GaimBlistNodeAction.
 */
GaimBlistNodeAction *gaim_blist_node_action_new(char *label,
		void (*callback)(GaimBlistNode *, gpointer), gpointer data,
		GList *children);


/**************************************************************************/
/** @name UI Registration Functions                                       */
/**************************************************************************/
/*@{*/

12919:248b8b39c671

#include <glib.h>

typedef struct _GaimBuddyList GaimBuddyList;
typedef struct _GaimBlistUiOps GaimBlistUiOps;
typedef struct _GaimBlistNode GaimBlistNode;

typedef struct _GaimChat GaimChat;
typedef struct _GaimGroup GaimGroup;
typedef struct _GaimContact GaimContact;
typedef struct _GaimBuddy GaimBuddy;

	void (*request_add_chat)(GaimAccount *account, GaimGroup *group,
							 const char *alias, const char *name);
	void (*request_add_group)(void);
};

#ifdef __cplusplus
extern "C" {
#endif

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

 */
GaimBlistNodeFlags gaim_blist_node_get_flags(GaimBlistNode *node);

/*@}*/

/**
 * Retrieves the extended menu items for a buddy list node.
 * @param n The blist node for which to obtain the extended menu items.
 * @return  A list of GaimMenuAction items, as harvested by the
 *          blist-node-extended-menu signal.
 */
GList *gaim_blist_node_get_extended_menu(GaimBlistNode *n);

/**************************************************************************/
/** @name UI Registration Functions                                       */
/**************************************************************************/
/*@{*/