Mercurial > pidgin

changeset 5477:e8e498255369

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[gaim-migrate @ 5873] The beginnings of the request API. committer: Tailor Script <tailor@pidgin.im>
author Christian Hammond <chipx86@chipx86.com>
date Thu, 22 May 2003 05:36:47 +0000
parents 9bcd8cd625ae
children bae3c48b9b4c
files src/Makefile.am src/request.c src/request.h
diffstat 3 files changed, 488 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/Makefile.am	Thu May 22 05:23:14 2003 +0000
+++ b/src/Makefile.am	Thu May 22 05:36:47 2003 +0000
@@ -30,6 +30,8 @@
 	prefs.h \
 	prpl.c \
 	prpl.h \
+	request.c \
+	request.h \
 	server.c \
 	sound.c \
 	sound.h \
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/request.c	Thu May 22 05:36:47 2003 +0000
@@ -0,0 +1,244 @@
+/**
+ * @file request.c Request API
+ * @ingroup core
+ *
+ * gaim
+ *
+ * Copyright (C) 2003 Christian Hammond <chipx86@gnupdate.org>
+ * 
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+#include "request.h"
+
+static GaimRequestUiOps *request_ui_ops = NULL;
+static GList *handles = NULL;
+
+typedef struct
+{
+	GaimRequestType type;
+	void *handle;
+	void *ui_handle;
+
+} GaimRequestInfo;
+
+
+void *
+gaim_request_input(void *handle, const char *title, const char *primary,
+				   const char *secondary, const char *default_value,
+				   const char *ok_text, GCallback ok_cb,
+				   const char *cancel_text, GCallback cancel_cb,
+				   void *user_data)
+{
+	GaimRequestUiOps *ops;
+
+	g_return_val_if_fail(primary != NULL, NULL);
+	g_return_val_if_fail(ok_text != NULL, NULL);
+	g_return_val_if_fail(ok_cb   != NULL, NULL);
+
+	ops = gaim_get_request_ui_ops();
+
+	if (ops != NULL && ops->request_input != NULL) {
+		GaimRequestInfo *info;
+
+		info            = g_new0(GaimRequestInfo, 1);
+		info->type      = GAIM_REQUEST_INPUT;
+		info->handle    = handle;
+		info->ui_handle = ops->request_input(title, primary, secondary,
+											 default_value, ok_text, ok_cb,
+											 cancel_text, cancel_cb,
+											 user_data);
+
+		handles = g_list_append(handles, info);
+
+		return info->ui_handle;
+	}
+
+	return NULL;
+}
+
+void *
+gaim_request_choice(void *handle, const char *title, const char *primary,
+					const char *secondary, unsigned int default_value,
+					const char *ok_text, GCallback ok_cb,
+					const char *cancel_text, GCallback cancel_cb,
+					void *user_data, const char *choice, ...)
+{
+	void *ui_handle;
+	va_list args;
+
+	g_return_val_if_fail(primary != NULL, NULL);
+	g_return_val_if_fail(ok_text != NULL, NULL);
+	g_return_val_if_fail(ok_cb   != NULL, NULL);
+	g_return_val_if_fail(choice  != NULL, NULL);
+
+	va_start(args, choice);
+	ui_handle = gaim_request_choice_varg(handle, title, primary, secondary,
+										 default_value, ok_text, ok_cb,
+										 cancel_text, cancel_cb, user_data,
+										 args);
+	va_end(args);
+
+	return ui_handle;
+}
+
+void *
+gaim_request_choice_varg(void *handle, const char *title,
+						 const char *primary, const char *secondary,
+						 unsigned int default_value,
+						 const char *ok_text, GCallback ok_cb,
+						 const char *cancel_text, GCallback cancel_cb,
+						 void *user_data, va_list choices)
+{
+	GaimRequestUiOps *ops;
+
+	g_return_val_if_fail(primary != NULL, NULL);
+	g_return_val_if_fail(ok_text != NULL, NULL);
+	g_return_val_if_fail(ok_cb   != NULL, NULL);
+
+	ops = gaim_get_request_ui_ops();
+
+	if (ops != NULL && ops->request_input != NULL) {
+		GaimRequestInfo *info;
+
+		info            = g_new0(GaimRequestInfo, 1);
+		info->type      = GAIM_REQUEST_CHOICE;
+		info->handle    = handle;
+		info->ui_handle = ops->request_choice(title, primary, secondary,
+											  default_value, ok_text, ok_cb,
+											  cancel_text, cancel_cb,
+											  user_data, choices);
+
+		handles = g_list_append(handles, info);
+
+		return info->ui_handle;
+	}
+
+	return NULL;
+}
+
+void *
+gaim_request_action(void *handle, const char *title, const char *primary,
+					const char *secondary, unsigned int default_action,
+					void *user_data, const char *action, ...)
+{
+	void *ui_handle;
+	va_list args;
+
+	g_return_val_if_fail(primary   != NULL, NULL);
+	g_return_val_if_fail(action    != NULL, NULL);
+
+	va_start(args, action);
+	ui_handle = gaim_request_action_varg(handle, title, primary, secondary,
+										 default_action, user_data, args);
+	va_end(args);
+
+	return ui_handle;
+}
+
+void *
+gaim_request_action_varg(void *handle, const char *title,
+						 const char *primary, const char *secondary,
+						 unsigned int default_action, void *user_data,
+						 va_list actions)
+{
+	GaimRequestUiOps *ops;
+
+	g_return_val_if_fail(primary != NULL, NULL);
+
+	ops = gaim_get_request_ui_ops();
+
+	if (ops != NULL && ops->request_input != NULL) {
+		GaimRequestInfo *info;
+
+		info            = g_new0(GaimRequestInfo, 1);
+		info->type      = GAIM_REQUEST_ACTION;
+		info->handle    = handle;
+		info->ui_handle = ops->request_action(title, primary, secondary,
+											  default_action, user_data,
+											  actions);
+
+		handles = g_list_append(handles, info);
+
+		return info->ui_handle;
+	}
+
+	return NULL;
+}
+
+void
+gaim_request_close(GaimRequestType type, void *ui_handle)
+{
+	GList *l;
+	GaimRequestUiOps *ops;
+
+	g_return_if_fail(ui_handle != NULL);
+
+	ops = gaim_get_request_ui_ops();
+
+	for (l = handles; l != NULL; l = l->next) {
+		GaimRequestInfo *info = l->data;
+
+		if (info->ui_handle == ui_handle) {
+			handles = g_list_remove(handles, info);
+
+			if (ops != NULL && ops->close_request != NULL)
+				ops->close_request(info->type, ui_handle);
+
+			g_free(info);
+
+			break;
+		}
+	}
+}
+
+void
+gaim_request_close_with_handle(void *handle)
+{
+	GList *l, *l_next;
+	GaimRequestUiOps *ops;
+
+	g_return_if_fail(handle != NULL);
+
+	ops = gaim_get_request_ui_ops();
+
+	for (l = handles; l != NULL; l = l_next) {
+		GaimRequestInfo *info = l->data;
+
+		l_next = l->next;
+
+		if (info->handle == handle) {
+			handles = g_list_remove(handles, info);
+
+			if (ops != NULL && ops->close_request != NULL)
+				ops->close_request(info->type, info->ui_handle);
+
+			g_free(info);
+		}
+	}
+}
+
+void
+gaim_set_request_ui_ops(GaimRequestUiOps *ops)
+{
+	request_ui_ops = ops;
+}
+
+GaimRequestUiOps *
+gaim_get_request_ui_ops(void)
+{
+	return request_ui_ops;
+}
+
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/request.h	Thu May 22 05:36:47 2003 +0000
@@ -0,0 +1,242 @@
+/**
+ * @file request.h Request API
+ * @ingroup core
+ *
+ * gaim
+ *
+ * Copyright (C) 2003 Christian Hammond <chipx86@gnupdate.org>
+ * 
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+#ifndef _GAIM_REQUEST_H_
+#define _GAIM_REQUEST_H_
+
+#include <stdlib.h>
+#include <glib-object.h>
+#include <glib.h>
+
+/**
+ * Request types.
+ */
+typedef enum
+{
+	GAIM_REQUEST_INPUT = 0,  /**< Text input request.      */
+	GAIM_REQUEST_CHOICE,     /**< Multiple-choice request. */
+	GAIM_REQUEST_ACTION      /**< Action request.          */
+
+} GaimRequestType;
+
+/**
+ * Request UI operations.
+ */
+typedef struct
+{
+	void *(*request_input)(const char *title, const char *primary,
+						   const char *secondary, const char *default_value,
+						   const char *ok_text, GCallback ok_cb,
+						   const char *cancel_text, GCallback cancel_cb,
+						   void *user_data);
+	void *(*request_choice)(const char *title, const char *primary,
+							const char *secondary, unsigned int default_value,
+							const char *ok_text, GCallback ok_cb,
+							const char *cancel_text, GCallback cancel_cb,
+							void *user_data, va_list args);
+	void *(*request_action)(const char *title, const char *primary,
+							const char *secondary, unsigned int default_action,
+							void *user_data, va_list actions);
+
+	void (*close_request)(GaimRequestType type, void *uihandle);
+
+} GaimRequestUiOps;
+
+/**************************************************************************/
+/** @name Request API                                                     */
+/**************************************************************************/
+/*@{*/
+
+/**
+ * Prompts the user for text input.
+ *
+ * @param handle        The plugin or connection handle.
+ * @param title         The title of the message.
+ * @param primary       The main point of the message.
+ * @param secondary     The secondary information.
+ * @param default_value The default value.
+ * @param ok_text       The text for the OK button.
+ * @param ok_cb         The callback for the OK button.
+ * @param cancel_text   The text for the cancel button.
+ * @param cancel_cb     The callback for the cancel button.
+ * @param user_data     The data to pass to the callback.
+ *
+ * @return A UI-specific handle.
+ */
+void *gaim_request_input(void *handle, const char *title,
+						 const char *primary, const char *secondary,
+						 const char *default_value,
+						 const char *ok_text, GCallback ok_cb,
+						 const char *cancel_text, GCallback cancel_cb,
+						 void *user_data);
+
+/**
+ * Prompts the user for multiple-choice input.
+ *
+ * @param handle        The plugin or connection handle.
+ * @param title         The title of the message.
+ * @param primary       The main point of the message.
+ * @param secondary     The secondary information.
+ * @param default_value The default value.
+ * @param ok_text       The text for the OK button.
+ * @param ok_cb         The callback for the OK button.
+ * @param cancel_text   The text for the cancel button.
+ * @param cancel_cb     The callback for the cancel button.
+ * @param user_data     The data to pass to the callback.
+ * @param choice        The choices.
+ *
+ * @return A UI-specific handle.
+ */
+void *gaim_request_choice(void *handle, const char *title,
+						  const char *primary, const char *secondary,
+						  unsigned int default_value,
+						  const char *ok_text, GCallback ok_cb,
+						  const char *cancel_text, GCallback cancel_cb,
+						  void *user_data,
+						  const char *choice, ...);
+
+/**
+ * Prompts the user for multiple-choice input.
+ *
+ * @param handle        The plugin or connection handle.
+ * @param title         The title of the message.
+ * @param primary       The main point of the message.
+ * @param secondary     The secondary information.
+ * @param default_value The default value.
+ * @param ok_text       The text for the OK button.
+ * @param ok_cb         The callback for the OK button.
+ * @param cancel_text   The text for the cancel button.
+ * @param cancel_cb     The callback for the cancel button.
+ * @param user_data     The data to pass to the callback.
+ * @param choices       The choices.
+ *
+ * @return A UI-specific handle.
+ */
+void *gaim_request_choice_varg(void *handle, const char *title,
+							   const char *primary, const char *secondary,
+							   unsigned int default_value,
+							   const char *ok_text, GCallback ok_cb,
+							   const char *cancel_text, GCallback cancel_cb,
+							   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.
+ *
+ * @param handle         The plugin or connection handle.
+ * @param title          The title of the message.
+ * @param primary        The main point of the message.
+ * @param secondary      The secondary information.
+ * @param default_action The default value.
+ * @param user_data      The data to pass to the callback.
+ * @param action         The first action.
+ *
+ * @return A UI-specific handle.
+ */
+void *gaim_request_action(void *handle, const char *title,
+						  const char *primary, const char *secondary,
+						  unsigned int default_action,
+						  void *user_data, const char *action, ...);
+
+/**
+ * Prompts the user for an action.
+ *
+ * This is often represented as a dialog with a button for each action.
+ *
+ * @param handle         The plugin or connection handle.
+ * @param title          The title of the message.
+ * @param primary        The main point of the message.
+ * @param secondary      The secondary information.
+ * @param default_action The default value.
+ * @param user_data      The data to pass to the callback.
+ * @param actions        A list of actions and callbacks.
+ *
+ * @return A UI-specific handle.
+ */
+void *gaim_request_action_varg(void *handle, const char *title,
+							   const char *primary, const char *secondary,
+							   unsigned int default_action,
+							   void *user_data, va_list actions);
+
+/**
+ * Closes a request.
+ *
+ * This should be used only by the UI operation functions and part of the
+ * core.
+ *
+ * @param type     The request type.
+ * @param uihandle The request UI handle.
+ */
+void gaim_request_close(GaimRequestType type, void *uihandle);
+
+/**
+ * Closes all requests registered with the specified handle.
+ *
+ * @param handle The handle.
+ */
+void gaim_request_close_with_handle(void *handle);
+
+/**
+ * A wrapper for gaim_request_action() that uses Yes and No buttons.
+ */
+#define gaim_request_yes_no(handle, title, primary, secondary, \
+							default_action, user_data, yes_cb, no_cb) \
+	gaim_request_action((handle), (title), (primary), (secondary) \
+						(default_action), (user_data), \
+						_("Yes"), (yes_cb), _("No"), (no_cb), NULL)
+
+/**
+ * A wrapper for gaim_request_action() that uses OK and Cancel buttons.
+ */
+#define gaim_request_ok_cancel(handle, title, primary, secondary, \
+							default_action, user_data, ok_cb, cancel_cb) \
+	gaim_request_action((handle), (title), (primary), (secondary) \
+						(default_action), (user_data), \
+						_("OK"), (ok_cb), _("Cancel"), (cancel_cb), NULL)
+
+/*@}*/
+
+/**************************************************************************/
+/** @name UI Operations API                                               */
+/**************************************************************************/
+/*@{*/
+
+/**
+ * Sets the UI operations structure to be used when displaying a
+ * request.
+ *
+ * @param ops The UI operations structure.
+ */
+void gaim_set_request_ui_ops(GaimRequestUiOps *ops);
+
+/**
+ * Returns the UI operations structure to be used when displaying a
+ * request.
+ *
+ * @param ops The UI operations structure.
+ */
+GaimRequestUiOps *gaim_get_request_ui_ops(void);
+
+/*@}*/
+
+#endif /* _GAIM_REQUEST_H_ */