comparison libpurple/request.h @ 21234:aabe638f56d9

Wrap the newly deprecated functions with #ifndef PURPLE_DISABLE_DEPRECATED.

21233:110f23ef3542

						 const char *ok_text, GCallback ok_cb,
						 const char *cancel_text, GCallback cancel_cb,
						 PurpleAccount *account, const char *who, PurpleConversation *conv,
						 const char *ui_hint, void *user_data);

/**
 * Prompts the user for text input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  The

						 gboolean multiline, gboolean masked, gchar *hint,
						 const char *ok_text, GCallback ok_cb,
						 const char *cancel_text, GCallback cancel_cb,
						 PurpleAccount *account, const char *who, PurpleConversation *conv,
						 void *user_data);

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some

						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  const char *ui_hint, void *user_data, ...) G_GNUC_NULL_TERMINATED;

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  See

						  int default_value,
						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data, ...) G_GNUC_NULL_TERMINATED;

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some

							   const char *ok_text, GCallback ok_cb,
							   const char *cancel_text, GCallback cancel_cb,
							   PurpleAccount *account, const char *who, PurpleConversation *conv,
							   const char *ui_hint, void *user_data, va_list choices);

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  See

							   int default_value,
							   const char *ok_text, GCallback ok_cb,
							   const char *cancel_text, GCallback cancel_cb,
							   PurpleAccount *account, const char *who, PurpleConversation *conv,
							   void *user_data, va_list choices);

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.

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

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.
 *

void *purple_request_action(void *handle, const char *title,
						  const char *primary, const char *secondary,
						  int default_action,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data, size_t action_count, ...);

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.

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

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.
 *

							   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

						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  const char *ui_hint, void *user_data);

/**
 * Displays groups of fields for the user to fill in.
 *
 * @param handle      The plugin or connection handle.  For some
 *                    things this is EXTREMELY important.  See

						  PurpleRequestFields *fields,
						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data);

/**
 * Closes a request.
 *
 * @param type     The request type.

							ui_hint, user_data, yes_cb, no_cb) \
	purple_request_action_with_hint((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (ui_hint), (user_data), 2, \
						_("_Yes"), (yes_cb), _("_No"), (no_cb))

/**
 * A wrapper for purple_request_action() that uses @c Yes and @c No buttons.
 *
 * @deprecated Please use purple_request_yes_no_with_hint instead.
 */

							default_action, account, who, conv, \
							user_data, yes_cb, no_cb) \
	purple_request_action((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (user_data), 2, \
						_("_Yes"), (yes_cb), _("_No"), (no_cb))

/**
 * A wrapper for purple_request_action() that uses @c OK and @c Cancel buttons.
 *
 * @since 2.3.0

						    ui_hint, user_data, ok_cb, cancel_cb) \
	purple_request_action_with_hint((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (ui_hint), (user_data), 2, \
						_("_OK"), (ok_cb), _("_Cancel"), (cancel_cb))

/**
 * A wrapper for purple_request_action() that uses @c OK and @c Cancel buttons.
 *
 * @deprecated Please use purple_request_ok_cancel_with_hint instead.
 */

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

/**
 * A wrapper for purple_request_action() that uses Accept and Cancel buttons.
 *
 * @since 2.3.0

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

/**
 * A wrapper for purple_request_action() that uses Accept and Cancel buttons.
 *
 * @deprecated Please use purple_request_accept_cancel_with_hint instead.
 */

								   default_action, account, who, conv, \
								   user_data, accept_cb, cancel_cb) \
	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.
 *

						gboolean savedialog,
						GCallback ok_cb, GCallback cancel_cb,
						PurpleAccount *account, const char *who, PurpleConversation *conv,
						const char *ui_hint, void *user_data);

/**
 * 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

void *purple_request_file(void *handle, const char *title, const char *filename,
						gboolean savedialog,
						GCallback ok_cb, GCallback cancel_cb,
						PurpleAccount *account, const char *who, PurpleConversation *conv,
						void *user_data);

/**
 * Displays a folder select dialog. Returns the selected filename to
 * the callback.
 *

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

/**
 * Displays a folder select dialog. Returns the selected filename to
 * the callback.
 *
 * @param handle      The plugin or connection handle.  For some

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

/*@}*/

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

21234:aabe638f56d9

						 const char *ok_text, GCallback ok_cb,
						 const char *cancel_text, GCallback cancel_cb,
						 PurpleAccount *account, const char *who, PurpleConversation *conv,
						 const char *ui_hint, void *user_data);

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Prompts the user for text input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  The

						 gboolean multiline, gboolean masked, gchar *hint,
						 const char *ok_text, GCallback ok_cb,
						 const char *cancel_text, GCallback cancel_cb,
						 PurpleAccount *account, const char *who, PurpleConversation *conv,
						 void *user_data);
#endif

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some

						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  const char *ui_hint, void *user_data, ...) G_GNUC_NULL_TERMINATED;

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  See

						  int default_value,
						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data, ...) G_GNUC_NULL_TERMINATED;
#endif

/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some

							   const char *ok_text, GCallback ok_cb,
							   const char *cancel_text, GCallback cancel_cb,
							   PurpleAccount *account, const char *who, PurpleConversation *conv,
							   const char *ui_hint, void *user_data, va_list choices);

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Prompts the user for multiple-choice input.
 *
 * @param handle        The plugin or connection handle.  For some
 *                      things this is EXTREMELY important.  See

							   int default_value,
							   const char *ok_text, GCallback ok_cb,
							   const char *cancel_text, GCallback cancel_cb,
							   PurpleAccount *account, const char *who, PurpleConversation *conv,
							   void *user_data, va_list choices);
#endif

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.

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

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.
 *

void *purple_request_action(void *handle, const char *title,
						  const char *primary, const char *secondary,
						  int default_action,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data, size_t action_count, ...);
#endif

/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.

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

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Prompts the user for an action.
 *
 * This is often represented as a dialog with a button for each action.
 *

							   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);
#endif

/**
 * Displays groups of fields for the user to fill in.
 *
 * @param handle      The plugin or connection handle.  For some

						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  const char *ui_hint, void *user_data);

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Displays groups of fields for the user to fill in.
 *
 * @param handle      The plugin or connection handle.  For some
 *                    things this is EXTREMELY important.  See

						  PurpleRequestFields *fields,
						  const char *ok_text, GCallback ok_cb,
						  const char *cancel_text, GCallback cancel_cb,
						  PurpleAccount *account, const char *who, PurpleConversation *conv,
						  void *user_data);
#endif

/**
 * Closes a request.
 *
 * @param type     The request type.

							ui_hint, user_data, yes_cb, no_cb) \
	purple_request_action_with_hint((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (ui_hint), (user_data), 2, \
						_("_Yes"), (yes_cb), _("_No"), (no_cb))

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * A wrapper for purple_request_action() that uses @c Yes and @c No buttons.
 *
 * @deprecated Please use purple_request_yes_no_with_hint instead.
 */

							default_action, account, who, conv, \
							user_data, yes_cb, no_cb) \
	purple_request_action((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (user_data), 2, \
						_("_Yes"), (yes_cb), _("_No"), (no_cb))
#endif

/**
 * A wrapper for purple_request_action() that uses @c OK and @c Cancel buttons.
 *
 * @since 2.3.0

						    ui_hint, user_data, ok_cb, cancel_cb) \
	purple_request_action_with_hint((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (ui_hint), (user_data), 2, \
						_("_OK"), (ok_cb), _("_Cancel"), (cancel_cb))

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * A wrapper for purple_request_action() that uses @c OK and @c Cancel buttons.
 *
 * @deprecated Please use purple_request_ok_cancel_with_hint instead.
 */

							default_action, account, who, conv, \
						    user_data, ok_cb, cancel_cb) \
	purple_request_action((handle), (title), (primary), (secondary), \
						(default_action), account, who, conv, (user_data), 2, \
						_("_OK"), (ok_cb), _("_Cancel"), (cancel_cb))
#endif

/**
 * A wrapper for purple_request_action() that uses Accept and Cancel buttons.
 *
 * @since 2.3.0

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

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * A wrapper for purple_request_action() that uses Accept and Cancel buttons.
 *
 * @deprecated Please use purple_request_accept_cancel_with_hint instead.
 */

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

/**
 * 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.
 *

						gboolean savedialog,
						GCallback ok_cb, GCallback cancel_cb,
						PurpleAccount *account, const char *who, PurpleConversation *conv,
						const char *ui_hint, void *user_data);

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * 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

void *purple_request_file(void *handle, const char *title, const char *filename,
						gboolean savedialog,
						GCallback ok_cb, GCallback cancel_cb,
						PurpleAccount *account, const char *who, PurpleConversation *conv,
						void *user_data);
#endif

/**
 * Displays a folder select dialog. Returns the selected filename to
 * the callback.
 *

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

#ifndef PURPLE_DISABLE_DEPRECATED
/**
 * Displays a folder select dialog. Returns the selected filename to
 * the callback.
 *
 * @param handle      The plugin or connection handle.  For some

 */
void *purple_request_folder(void *handle, const char *title, const char *dirname,
						GCallback ok_cb, GCallback cancel_cb,
						PurpleAccount *account, const char *who, PurpleConversation *conv,
						void *user_data);
#endif

/*@}*/

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