# HG changeset patch # User Christian Hammond # Date 1053581807 0 # Node ID e8e498255369e5208e8ff6a22a69e5110a6f5007 # Parent 9bcd8cd625aeaae1cffe479d14825690d1549f9a [gaim-migrate @ 5873] The beginnings of the request API. committer: Tailor Script diff -r 9bcd8cd625ae -r e8e498255369 src/Makefile.am --- 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 \ diff -r 9bcd8cd625ae -r e8e498255369 src/request.c --- /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 + * + * 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; +} + + diff -r 9bcd8cd625ae -r e8e498255369 src/request.h --- /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 + * + * 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 +#include +#include + +/** + * 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_ */