#include <stdlib.h>
#include <glib-object.h>
#include <glib.h>
#include "account.h"
Include dependency graph for request.h:
This graph shows which files directly or indirectly include this file:
Go to the source code of this file.
Data Structures | |
struct | GaimRequestField |
A request field. More... | |
struct | GaimRequestFieldGroup |
A group of fields with a title. More... | |
struct | GaimRequestFields |
Multiple fields request data. More... | |
struct | GaimRequestUiOps |
Request UI operations. More... | |
Request API | |
#define | gaim_request_yes_no(handle, title, primary, secondary, default_action, user_data, yes_cb, no_cb) |
A wrapper for gaim_request_action() that uses Yes and No buttons. | |
#define | gaim_request_ok_cancel(handle, title, primary, secondary, default_action, user_data, ok_cb, cancel_cb) |
A wrapper for gaim_request_action() that uses OK and Cancel buttons. | |
#define | gaim_request_accept_cancel(handle, title, primary, secondary, default_action, user_data, accept_cb, cancel_cb) |
A wrapper for gaim_request_action() that uses Accept and Cancel buttons. | |
void * | gaim_request_input (void *handle, const char *title, const char *primary, const char *secondary, const char *default_value, gboolean multiline, gboolean masked, gchar *hint, const char *ok_text, GCallback ok_cb, const char *cancel_text, GCallback cancel_cb, void *user_data) |
Prompts the user for text input. | |
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, size_t choice_count,...) |
Prompts the user for multiple-choice input. | |
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, size_t choice_count, va_list choices) |
Prompts the user for multiple-choice input. | |
void * | gaim_request_action (void *handle, const char *title, const char *primary, const char *secondary, unsigned int default_action, void *user_data, size_t action_count,...) |
Prompts the user for an action. | |
void * | gaim_request_action_varg (void *handle, const char *title, const char *primary, const char *secondary, unsigned int default_action, void *user_data, size_t action_count, va_list actions) |
Prompts the user for an action. | |
void * | gaim_request_fields (void *handle, const char *title, const char *primary, const char *secondary, GaimRequestFields *fields, const char *ok_text, GCallback ok_cb, const char *cancel_text, GCallback cancel_cb, void *user_data) |
Displays groups of fields for the user to fill in. | |
void | gaim_request_close (GaimRequestType type, void *uihandle) |
Closes a request. | |
void | gaim_request_close_with_handle (void *handle) |
Closes all requests registered with the specified handle. | |
Field List API | |
GaimRequestFields * | gaim_request_fields_new (void) |
Creates a list of fields to pass to gaim_request_fields(). | |
void | gaim_request_fields_destroy (GaimRequestFields *fields) |
Destroys a list of fields. | |
void | gaim_request_fields_add_group (GaimRequestFields *fields, GaimRequestFieldGroup *group) |
Adds a group of fields to the list. | |
GList * | gaim_request_fields_get_groups (const GaimRequestFields *fields) |
Returns a list of all groups in a field list. | |
gboolean | gaim_request_fields_exists (const GaimRequestFields *fields, const char *id) |
Returns whether or not the field with the specified ID exists. | |
const GList * | gaim_request_fields_get_required (const GaimRequestFields *fields) |
Returns a list of all required fields. | |
gboolean | gaim_request_fields_is_field_required (const GaimRequestFields *fields, const char *id) |
Returns whether or not a field with the specified ID is required. | |
gboolean | gaim_request_fields_all_required_filled (const GaimRequestFields *fields) |
Returns whether or not all required fields have values. | |
GaimRequestField * | gaim_request_fields_get_field (const GaimRequestFields *fields, const char *id) |
Return the field with the specified ID. | |
const char * | gaim_request_fields_get_string (const GaimRequestFields *fields, const char *id) |
Returns the string value of a field with the specified ID. | |
int | gaim_request_fields_get_integer (const GaimRequestFields *fields, const char *id) |
Returns the integer value of a field with the specified ID. | |
gboolean | gaim_request_fields_get_bool (const GaimRequestFields *fields, const char *id) |
Returns the boolean value of a field with the specified ID. | |
int | gaim_request_fields_get_choice (const GaimRequestFields *fields, const char *id) |
Returns the choice index of a field with the specified ID. | |
GaimAccount * | gaim_request_fields_get_account (const GaimRequestFields *fields, const char *id) |
Returns the account of a field with the specified ID. | |
Fields Group API | |
GaimRequestFieldGroup * | gaim_request_field_group_new (const char *title) |
Creates a fields group with an optional title. | |
void | gaim_request_field_group_destroy (GaimRequestFieldGroup *group) |
Destroys a fields group. | |
void | gaim_request_field_group_add_field (GaimRequestFieldGroup *group, GaimRequestField *field) |
Adds a field to the group. | |
const char * | gaim_request_field_group_get_title (const GaimRequestFieldGroup *group) |
Returns the title of a fields group. | |
GList * | gaim_request_field_group_get_fields (const GaimRequestFieldGroup *group) |
Returns a list of all fields in a group. | |
Field API | |
GaimRequestField * | gaim_request_field_new (const char *id, const char *text, GaimRequestFieldType type) |
Creates a field of the specified type. | |
void | gaim_request_field_destroy (GaimRequestField *field) |
Destroys a field. | |
void | gaim_request_field_set_label (GaimRequestField *field, const char *label) |
Sets the label text of a field. | |
void | gaim_request_field_set_visible (GaimRequestField *field, gboolean visible) |
Sets whether or not a field is visible. | |
void | gaim_request_field_set_type_hint (GaimRequestField *field, const char *type_hint) |
Sets the type hint for the field. | |
void | gaim_request_field_set_required (GaimRequestField *field, gboolean required) |
Sets whether or not a field is required. | |
GaimRequestFieldType | gaim_request_field_get_type (const GaimRequestField *field) |
Returns the type of a field. | |
const char * | gaim_request_field_get_id (const GaimRequestField *field) |
Returns the ID of a field. | |
const char * | gaim_request_field_get_label (const GaimRequestField *field) |
Returns the label text of a field. | |
gboolean | gaim_request_field_is_visible (const GaimRequestField *field) |
Returns whether or not a field is visible. | |
const char * | gaim_request_field_get_type_hint (const GaimRequestField *field) |
Returns the field's type hint. | |
gboolean | gaim_request_field_is_required (const GaimRequestField *field) |
Returns whether or not a field is required. | |
String Field API | |
GaimRequestField * | gaim_request_field_string_new (const char *id, const char *text, const char *default_value, gboolean multiline) |
Creates a string request field. | |
void | gaim_request_field_string_set_default_value (GaimRequestField *field, const char *default_value) |
Sets the default value in a string field. | |
void | gaim_request_field_string_set_value (GaimRequestField *field, const char *value) |
Sets the value in a string field. | |
void | gaim_request_field_string_set_masked (GaimRequestField *field, gboolean masked) |
Sets whether or not a string field is masked (commonly used for password fields). | |
void | gaim_request_field_string_set_editable (GaimRequestField *field, gboolean editable) |
Sets whether or not a string field is editable. | |
const char * | gaim_request_field_string_get_default_value (const GaimRequestField *field) |
Returns the default value in a string field. | |
const char * | gaim_request_field_string_get_value (const GaimRequestField *field) |
Returns the user-entered value in a string field. | |
gboolean | gaim_request_field_string_is_multiline (const GaimRequestField *field) |
Returns whether or not a string field is multi-line. | |
gboolean | gaim_request_field_string_is_masked (const GaimRequestField *field) |
Returns whether or not a string field is masked. | |
gboolean | gaim_request_field_string_is_editable (const GaimRequestField *field) |
Returns whether or not a string field is editable. | |
Integer Field API | |
GaimRequestField * | gaim_request_field_int_new (const char *id, const char *text, int default_value) |
Creates an integer field. | |
void | gaim_request_field_int_set_default_value (GaimRequestField *field, int default_value) |
Sets the default value in an integer field. | |
void | gaim_request_field_int_set_value (GaimRequestField *field, int value) |
Sets the value in an integer field. | |
int | gaim_request_field_int_get_default_value (const GaimRequestField *field) |
Returns the default value in an integer field. | |
int | gaim_request_field_int_get_value (const GaimRequestField *field) |
Returns the user-entered value in an integer field. | |
Boolean Field API | |
GaimRequestField * | gaim_request_field_bool_new (const char *id, const char *text, gboolean default_value) |
Creates a boolean field. | |
void | gaim_request_field_bool_set_default_value (GaimRequestField *field, gboolean default_value) |
Sets the default value in an boolean field. | |
void | gaim_request_field_bool_set_value (GaimRequestField *field, gboolean value) |
Sets the value in an boolean field. | |
gboolean | gaim_request_field_bool_get_default_value (const GaimRequestField *field) |
Returns the default value in an boolean field. | |
gboolean | gaim_request_field_bool_get_value (const GaimRequestField *field) |
Returns the user-entered value in an boolean field. | |
Choice Field API | |
GaimRequestField * | gaim_request_field_choice_new (const char *id, const char *text, int default_value) |
Creates a multiple choice field. | |
void | gaim_request_field_choice_add (GaimRequestField *field, const char *label) |
Adds a choice to a multiple choice field. | |
void | gaim_request_field_choice_set_default_value (GaimRequestField *field, int default_value) |
Sets the default value in an choice field. | |
void | gaim_request_field_choice_set_value (GaimRequestField *field, int value) |
Sets the value in an choice field. | |
int | gaim_request_field_choice_get_default_value (const GaimRequestField *field) |
Returns the default value in an choice field. | |
int | gaim_request_field_choice_get_value (const GaimRequestField *field) |
Returns the user-entered value in an choice field. | |
GList * | gaim_request_field_choice_get_labels (const GaimRequestField *field) |
Returns a list of labels in a choice field. | |
List Field API | |
GaimRequestField * | gaim_request_field_list_new (const char *id, const char *text) |
Creates a multiple list item field. | |
void | gaim_request_field_list_set_multi_select (GaimRequestField *field, gboolean multi_select) |
Sets whether or not a list field allows multiple selection. | |
gboolean | gaim_request_field_list_get_multi_select (const GaimRequestField *field) |
Returns whether or not a list field allows multiple selection. | |
void * | gaim_request_field_list_get_data (const GaimRequestField *field, const char *text) |
Returns the data for a particular item. | |
void | gaim_request_field_list_add (GaimRequestField *field, const char *item, void *data) |
Adds an item to a list field. | |
void | gaim_request_field_list_add_selected (GaimRequestField *field, const char *item) |
Adds a selected item to the list field. | |
void | gaim_request_field_list_clear_selected (GaimRequestField *field) |
Clears the list of selected items in a list field. | |
void | gaim_request_field_list_set_selected (GaimRequestField *field, GList *items) |
Sets a list of selected items in a list field. | |
gboolean | gaim_request_field_list_is_selected (const GaimRequestField *field, const char *item) |
Returns whether or not a particular item is selected in a list field. | |
const GList * | gaim_request_field_list_get_selected (const GaimRequestField *field) |
Returns a list of selected items in a list field. | |
const GList * | gaim_request_field_list_get_items (const GaimRequestField *field) |
Returns a list of items in a list field. | |
Label Field API | |
GaimRequestField * | gaim_request_field_label_new (const char *id, const char *text) |
Creates a label field. | |
Account Field API | |
GaimRequestField * | gaim_request_field_account_new (const char *id, const char *text, GaimAccount *account) |
Creates an account field. | |
void | gaim_request_field_account_set_default_value (GaimRequestField *field, GaimAccount *default_value) |
Sets the default account on an account field. | |
void | gaim_request_field_account_set_value (GaimRequestField *field, GaimAccount *value) |
Sets the account in an account field. | |
void | gaim_request_field_account_set_show_all (GaimRequestField *field, gboolean show_all) |
Sets whether or not to show all accounts in an account field. | |
void | gaim_request_field_account_set_filter (GaimRequestField *field, GaimFilterAccountFunc filter_func) |
Sets the account filter function in an account field. | |
GaimAccount * | gaim_request_field_account_get_default_value (const GaimRequestField *field) |
Returns the default account in an account field. | |
GaimAccount * | gaim_request_field_account_get_value (const GaimRequestField *field) |
Returns the user-entered account in an account field. | |
gboolean | gaim_request_field_account_get_show_all (const GaimRequestField *field) |
Returns whether or not to show all accounts in an account field. | |
GaimFilterAccountFunc | gaim_request_field_account_get_filter (const GaimRequestField *field) |
Returns the account filter function in an account field. | |
UI Operations API | |
void | gaim_request_set_ui_ops (GaimRequestUiOps *ops) |
Sets the UI operations structure to be used when displaying a request. | |
GaimRequestUiOps * | gaim_request_get_ui_ops (void) |
Returns the UI operations structure to be used when displaying a request. | |
Typedefs | |
typedef void(* | GaimRequestInputCb )(void *, const char *) |
typedef void(* | GaimRequestActionCb )(void *, int) |
typedef void(* | GaimRequestFieldsCb )(void *, GaimRequestFields *fields) |
Enumerations | |
enum | GaimRequestType { GAIM_REQUEST_INPUT = 0, GAIM_REQUEST_CHOICE, GAIM_REQUEST_ACTION, GAIM_REQUEST_FIELDS } |
Request types. More... | |
enum | GaimRequestFieldType { GAIM_REQUEST_FIELD_NONE, GAIM_REQUEST_FIELD_STRING, GAIM_REQUEST_FIELD_INTEGER, GAIM_REQUEST_FIELD_BOOLEAN, GAIM_REQUEST_FIELD_CHOICE, GAIM_REQUEST_FIELD_LIST, GAIM_REQUEST_FIELD_LABEL, GAIM_REQUEST_FIELD_ACCOUNT } |
A type of field. |
gaim
Gaim is the legal property of its developers, whose names are too numerous to list here. Please refer to the COPYRIGHT file distributed with this source distribution.
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
|
Value: gaim_request_action((handle), (title), (primary), (secondary), \ (default_action), (user_data), 2, \ _("Accept"), (accept_cb), _("Cancel"), (cancel_cb))
|
|
Value: gaim_request_action((handle), (title), (primary), (secondary), \ (default_action), (user_data), 2, \ _("OK"), (ok_cb), _("Cancel"), (cancel_cb))
|
|
Value: gaim_request_action((handle), (title), (primary), (secondary), \ (default_action), (user_data), 2, \ _("Yes"), (yes_cb), _("No"), (no_cb))
|
|
Request types.
|
|
Prompts the user for an action. This is often represented as a dialog with a button for each action.
|
|
Prompts the user for an action. This is often represented as a dialog with a button for each action.
|
|
Prompts the user for multiple-choice input.
|
|
Prompts the user for multiple-choice input.
|
|
Closes a request.
|
|
Closes all requests registered with the specified handle.
|
|
Returns the default account in an account field.
|
|
Returns the account filter function in an account field. This function will determine which accounts get displayed and which don't.
|
|
Returns whether or not to show all accounts in an account field. If TRUE, all accounts, online or offline, will be shown. If FALSE, only online accounts will be shown.
|
|
Returns the user-entered account in an account field.
|
|
Creates an account field. By default, this field will not show offline accounts.
|
|
Sets the default account on an account field.
|
|
Sets the account filter function in an account field. This function will determine which accounts get displayed and which don't.
|
|
Sets whether or not to show all accounts in an account field. If TRUE, all accounts, online or offline, will be shown. If FALSE, only online accounts will be shown.
|
|
Sets the account in an account field.
|
|
Returns the default value in an boolean field.
|
|
Returns the user-entered value in an boolean field.
|
|
Creates a boolean field. This is often represented as a checkbox.
|
|
Sets the default value in an boolean field.
|
|
Sets the value in an boolean field.
|
|
Adds a choice to a multiple choice field.
|
|
Returns the default value in an choice field.
|
|
Returns a list of labels in a choice field.
|
|
Returns the user-entered value in an choice field.
|
|
Creates a multiple choice field. This is often represented as a group of radio buttons.
|
|
Sets the default value in an choice field.
|
|
Sets the value in an choice field.
|
|
Destroys a field.
|
|
Returns the ID of a field.
|
|
Returns the label text of a field.
|
|
Returns the type of a field.
|
|
Returns the field's type hint.
|
|
Adds a field to the group.
|
|
Destroys a fields group.
|
|
Returns a list of all fields in a group.
|
|
Returns the title of a fields group.
|
|
Creates a fields group with an optional title.
|
|
Returns the default value in an integer field.
|
|
Returns the user-entered value in an integer field.
|
|
Creates an integer field.
|
|
Sets the default value in an integer field.
|
|
Sets the value in an integer field.
|
|
Returns whether or not a field is required.
|
|
Returns whether or not a field is visible.
|
|
Creates a label field.
|
|
Adds an item to a list field.
|
|
Adds a selected item to the list field.
|
|
Clears the list of selected items in a list field.
|
|
Returns the data for a particular item.
|
|
Returns a list of items in a list field.
|
|
Returns whether or not a list field allows multiple selection.
|
|
Returns a list of selected items in a list field. To retrieve the data for each item, use gaim_request_field_list_get_data().
|
|
Returns whether or not a particular item is selected in a list field.
|
|
Creates a multiple list item field.
|
|
Sets whether or not a list field allows multiple selection.
|
|
Sets a list of selected items in a list field.
|
|
Creates a field of the specified type.
|
|
Sets the label text of a field.
|
|
Sets whether or not a field is required.
|
|
Sets the type hint for the field. This is optionally used by the UIs to provide such features as auto-completion for type hints like "screenname."
|
|
Sets whether or not a field is visible.
|
|
Returns the default value in a string field.
|
|
Returns the user-entered value in a string field.
|
|
Returns whether or not a string field is editable.
|
|
Returns whether or not a string field is masked.
|
|
Returns whether or not a string field is multi-line.
|
|
Creates a string request field.
|
|
Sets the default value in a string field.
|
|
Sets whether or not a string field is editable.
|
|
Sets whether or not a string field is masked (commonly used for password fields).
|
|
Sets the value in a string field.
|
|
Displays groups of fields for the user to fill in.
|
|
Adds a group of fields to the list.
|
|
Returns whether or not all required fields have values.
|
|
Destroys a list of fields.
|
|
Returns whether or not the field with the specified ID exists.
|
|
Returns the account of a field with the specified ID.
|
|
Returns the boolean value of a field with the specified ID.
|
|
Returns the choice index of a field with the specified ID.
|
|
Return the field with the specified ID.
|
|
Returns a list of all groups in a field list.
|
|
Returns the integer value of a field with the specified ID.
|
|
Returns a list of all required fields.
|
|
Returns the string value of a field with the specified ID.
|
|
Returns whether or not a field with the specified ID is required.
|
|
Creates a list of fields to pass to gaim_request_fields().
|
|
Returns the UI operations structure to be used when displaying a request.
|
|
Prompts the user for text input.
|
|
Sets the UI operations structure to be used when displaying a request.
|