comparison libpurple/request.h @ 29842:4eb6ac47f01f

propagate from branch 'im.pidgin.cpw.malu.ft_thumbnails' (head 98d8db26c6d12378d0113a97c8b3f989233a5cbc) to branch 'im.pidgin.pidgin' (head 024731c3cb9e8c0e0479d91f68aeaf7fae9a978b)

29781:65c7e53d4bdb

	void *(*request_folder)(const char *title, const char *dirname,
	                        GCallback ok_cb, GCallback cancel_cb,
	                        PurpleAccount *account, const char *who,
	                        PurpleConversation *conv, void *user_data);

	void (*_purple_reserved1)(void);
	void (*_purple_reserved2)(void);
	void (*_purple_reserved3)(void);
	void (*_purple_reserved4)(void);
} PurpleRequestUiOps;

typedef void (*PurpleRequestInputCb)(void *, const char *);

/** The type of callbacks passed to purple_request_action().  The first

	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	void *user_data, size_t action_count, va_list actions);

/**
 * Displays groups of fields for the user to fill in.
 *
 * @param handle      The plugin or connection handle.  For some things this
 *                    is <em>extremely</em> important.  See the comments on
 *                    purple_request_input().

	purple_request_action((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (user_data), 2, \
						_("_Accept"), (accept_cb), _("_Cancel"), (cancel_cb))

/**
 * Displays a file selector request dialog.  Returns the selected filename to
 * the callback.  Can be used for either opening a file or saving a file.
 *
 * @param handle      The plugin or connection handle.  For some things this
 *                    is <em>extremely</em> important.  See the comments on

29842:4eb6ac47f01f

	void *(*request_folder)(const char *title, const char *dirname,
	                        GCallback ok_cb, GCallback cancel_cb,
	                        PurpleAccount *account, const char *who,
	                        PurpleConversation *conv, void *user_data);

	/** @see purple_request_action_varg_with_icon(). */
	void *(*request_action_with_icon)(const char *title, const char *primary,
	                        const char *secondary, int default_action,
	                        PurpleAccount *account, const char *who,
	                        PurpleConversation *conv, 
	                        gconstpointer icon_data, gsize icon_size,
	                        void *user_data,
	                        size_t action_count, va_list actions);

	void (*_purple_reserved1)(void);
	void (*_purple_reserved2)(void);
	void (*_purple_reserved3)(void);
} PurpleRequestUiOps;

typedef void (*PurpleRequestInputCb)(void *, const char *);

/** The type of callbacks passed to purple_request_action().  The first

	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	void *user_data, size_t action_count, va_list actions);

/**
 * Version of purple_request_action() supplying an image for the UI to 
 * optionally display as an icon in the dialog; see its documentation
 * @since 2.7.0
 */
void *purple_request_action_with_icon(void *handle, const char *title, 
	const char *primary, const char *secondary, int default_action, 
	PurpleAccount *account, const char *who, PurpleConversation *conv, 
	gconstpointer icon_data, gsize icon_size, void *user_data, 
	size_t action_count, ...);

/**
 * <tt>va_list</tt> version of purple_request_action_with_icon(); 
 * see its documentation.
 * @since 2.7.0
 */
void *purple_request_action_varg_with_icon(void *handle, const char *title,
	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	gconstpointer icon_data, gsize icon_size,
	void *user_data, size_t action_count, va_list actions);


/**
 * Displays groups of fields for the user to fill in.
 *
 * @param handle      The plugin or connection handle.  For some things this
 *                    is <em>extremely</em> important.  See the comments on
 *                    purple_request_input().

	purple_request_action((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (user_data), 2, \
						_("_Accept"), (accept_cb), _("_Cancel"), (cancel_cb))

/**
 * A wrapper for purple_request_action_with_icon() that uses Accept and Cancel 
 * buttons.
 */
#define purple_request_accept_cancel_with_icon(handle, title, primary, secondary, \
								   default_action, account, who, conv, \
								   icon_data, icon_size, \
								   user_data, accept_cb, cancel_cb) \
	purple_request_action_with_icon((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, icon_data, icon_size, \
						(user_data), 2, \
						_("_Accept"), (accept_cb), _("_Cancel"), (cancel_cb))

/**
 * Displays a file selector request dialog.  Returns the selected filename to
 * the callback.  Can be used for either opening a file or saving a file.
 *
 * @param handle      The plugin or connection handle.  For some things this
 *                    is <em>extremely</em> important.  See the comments on