emufs_gui/form.h

   1 /* Manejo de Formularios con CURSES */
   2
   3 #ifndef _FORM_H_
   4 #define _FORM_H_
   5
   6 #include <string.h>
   7 #include <stdlib.h>
   8 #include <curses.h>
   9
  10 #include "malloc_debug.h"
  11
  12 /** Tipos de Widgets válidos */
  13 typedef enum {INPUT, RADIO} t_Campo;
  14
  15 /** Tipo de dato Widget */
  16 typedef struct _elem_ {
  17         /** Nombre */
  18         char *nombre;
  19         /** Tipo */
  20         t_Campo tipo;
  21         /** Dato a manejar
  22          *
  23          *  El dato puede ser simple o múltiple, dependiendo
  24          *  si se opta por referencias valor u opciones.
  25          *
  26          *  Consulte la documentación de union de ANSI-C para
  27          *  mas datos
  28          */
  29         union {
  30                 char *valor;
  31                 char **opciones;
  32         };
  33         /** Elemento actual (si se utiliza valores múltiples */
  34         unsigned int actual;
  35         /** Máximo de elementos
  36          *
  37          *  El uso varía según el Widget :
  38          *   INPUT : Cantidad máxima de caracteres.
  39          *   RADIO : Cantidad de Opciones
  40          */
  41         unsigned int max;
  42         /** Formato del campo de entrada */
  43         char *format;
  44         /** Siguiente elemento */
  45         struct _elem_ *sig;
  46
  47         /* Métodos */
  48         int (*ejecutar)(WINDOW *win, int x, int y, struct _elem_ *w);
  49         void (*destruir)(struct _elem_ *);
  50 } t_Widget;
  51
  52 typedef struct _form_ {
  53         t_Widget *primero, *ultimo; /* puntero a widgets */
  54         WINDOW *win;
  55 } t_Form;
  56
  57 /** Inicializa un formulario
  58  *
  59  *  \param win Ventana a la que pertenece
  60  * */
  61 t_Form *form_crear(WINDOW *win);
  62
  63 /** Libera un formulario */
  64 int form_destruir(t_Form *);
  65 /** Agrega un nuevo campo
  66  *
  67  *  Significado de <em>max</em> según tipo:
  68  *    INPUT : Cantidad máxima de caracteres de la entrada.
  69  *    RADIO : Cantidad de opciones
  70  *
  71  *  Significado de <em>defecto</em> según tipo
  72  *    INPUT : Nada.
  73  *    RADIO : Texto separado por comas (',') de las opciones disponibles.
  74  *
  75  *  \param f Formulario
  76  *  \param tipo Tipo de campo a agregar [INPUT|RADIO].
  77  *  \param nombre Nombre del campo. Es también utilizado como etiqueta.
  78  *  \param max Su uso depende del campo tipo.
  79  *  \param defecto Su uso depende del campo tipo.
  80  */
  81 void form_agregar_widget(t_Form *f, t_Campo tipo, const char *nombre, unsigned int max, const char *defecto);
  82
  83 /** Ejecuta una entrada del formulario
  84  *
  85  *  Esta función va recorriendo uno por uno los campos del formulario
  86  *  y dependiendo del tipo ejecutando su acción asociada.
  87  *
  88  *  Cuando se ha pasado por todos los campos el formulario retorna el control.
  89  *
  90  *  \param f Formulario.
  91  *  \param x Coordenada X de inicio del formulario.
  92  *  \param y Coordenada Y de inicio del formulario.
  93  */
  94 void form_ejecutar(t_Form *f, int x, int y);
  95
  96 /** Obtiene el valor asociado a un campo como char *
  97  *
  98  *  \param f Formulario.
  99  *  \param widget Nombre del campo.
 100  *  \return "" Si no se encontro nada.
 101  */
 102 char *form_obtener_valor_char(t_Form *f, const char *widget);
 103
 104 /** Obtiene el valor asociado a un campo como int
 105  */
 106 int form_obtener_valor_int(t_Form *f, const char *widget);
 107
 108 /** Obtiene el valor asociado a un campo como float
 109  */
 110 float form_obtener_valor_float(t_Form *f, const char *widget);
 111
 112 #endif
 113