comparison libpurple/request.h @ 25883:e22bc87b758b

explicit merge of '9a5e549612efd8ca6f60fc57b51a4eee7e32c861' and 'f398f87ffee8b1b11295a0a0138936074c5dff7a'
author Richard Laager <rlaager@wiktel.com>
date Fri, 02 Jan 2009 22:09:40 +0000
parents 5d681e194fb3
children d25cbbea7fe5
comparison
equal deleted inserted replaced
24767:295464ae2d2a 25883:e22bc87b758b
27 #define _PURPLE_REQUEST_H_ 27 #define _PURPLE_REQUEST_H_
28 28
29 #include <stdlib.h> 29 #include <stdlib.h>
30 #include <glib-object.h> 30 #include <glib-object.h>
31 #include <glib.h> 31 #include <glib.h>
32
33 /** @copydoc _PurpleRequestField */
34 typedef struct _PurpleRequestField PurpleRequestField;
32 35
33 #include "account.h" 36 #include "account.h"
34 37
35 #define PURPLE_DEFAULT_ACTION_NONE -1 38 #define PURPLE_DEFAULT_ACTION_NONE -1
36 39
91 94
92 GList *fields; 95 GList *fields;
93 96
94 } PurpleRequestFieldGroup; 97 } PurpleRequestFieldGroup;
95 98
99 #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_REQUEST_C_)
96 /** 100 /**
97 * A request field. 101 * A request field.
98 */ 102 */
99 typedef struct 103 struct _PurpleRequestField
100 { 104 {
101 PurpleRequestFieldType type; 105 PurpleRequestFieldType type;
102 PurpleRequestFieldGroup *group; 106 PurpleRequestFieldGroup *group;
103 107
104 char *id; 108 char *id;
174 178
175 } u; 179 } u;
176 180
177 void *ui_data; 181 void *ui_data;
178 182
179 } PurpleRequestField; 183 };
184 #endif
180 185
181 /** 186 /**
182 * Request UI operations. 187 * Request UI operations.
183 */ 188 */
184 typedef struct 189 typedef struct
519 * @return The field's type. 524 * @return The field's type.
520 */ 525 */
521 PurpleRequestFieldType purple_request_field_get_type(const PurpleRequestField *field); 526 PurpleRequestFieldType purple_request_field_get_type(const PurpleRequestField *field);
522 527
523 /** 528 /**
529 * Returns the group for the field.
530 *
531 * @param field The field.
532 *
533 * @return The UI data.
534 * @since 2.6.0
535 */
536 PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);
537
538 /**
524 * Returns the ID of a field. 539 * Returns the ID of a field.
525 * 540 *
526 * @param field The field. 541 * @param field The field.
527 * 542 *
528 * @return The ID 543 * @return The ID
562 * @param field The field. 577 * @param field The field.
563 * 578 *
564 * @return TRUE if the field is required, or FALSE. 579 * @return TRUE if the field is required, or FALSE.
565 */ 580 */
566 gboolean purple_request_field_is_required(const PurpleRequestField *field); 581 gboolean purple_request_field_is_required(const PurpleRequestField *field);
582
583 /**
584 * Returns the ui_data for a field.
585 *
586 * @param field The field.
587 *
588 * @return The UI data.
589 * @since 2.6.0
590 */
591 gpointer purple_request_field_get_ui_data(const PurpleRequestField *field);
592
593 /**
594 * Sets the ui_data for a field.
595 *
596 * @param field The field.
597 * @param ui_data The UI data.
598 *
599 * @return The UI data.
600 * @since 2.6.0
601 */
602 void purple_request_field_set_ui_data(PurpleRequestField *field,
603 gpointer ui_data);
567 604
568 /*@}*/ 605 /*@}*/
569 606
570 /**************************************************************************/ 607 /**************************************************************************/
571 /** @name String Field API */ 608 /** @name String Field API */