mc/lib/widget/quick.h

/** \file quick.h
 *  \brief Header: quick dialog engine
 */

#ifndef MC__QUICK_H
#define MC__QUICK_H

/*** typedefs(not structures) and defined constants **********************************************/

#define QUICK_CHECKBOX(txt, st, id_)                                            \
{                                                                               \
    .widget_type = quick_checkbox,                                              \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .checkbox = {                                                           \
            .text = txt,                                                        \
            .state = st                                                         \
        }                                                                       \
    }                                                                           \
}

#define QUICK_BUTTON(txt, act, cb, id_)                                         \
{                                                                               \
    .widget_type = quick_button,                                                \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .button = {                                                             \
            .text = txt,                                                        \
            .action = act,                                                      \
            .callback = cb                                                      \
        }                                                                       \
    }                                                                           \
}

#define QUICK_INPUT(txt, hname, res, id_, is_passwd_, strip_passwd_, completion_flags_) \
{                                                                               \
    .widget_type = quick_input,                                                 \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .input = {                                                              \
            .label_text = NULL,                                                 \
            .label_location = input_label_none,                                 \
            .label = NULL,                                                      \
            .text = txt,                                                        \
            .completion_flags = completion_flags_,                              \
            .is_passwd = is_passwd_,                                            \
            .strip_passwd = strip_passwd_,                                      \
            .histname = hname,                                                  \
            .result = res                                                       \
        }                                                                       \
    }                                                                           \
}

#define QUICK_LABELED_INPUT(label_, label_loc, txt, hname, res, id_, is_passwd_, strip_passwd_, completion_flags_) \
{                                                                               \
    .widget_type = quick_input,                                                 \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .input = {                                                              \
            .label_text = label_,                                               \
            .label_location = label_loc,                                        \
            .label = NULL,                                                      \
            .text = txt,                                                        \
            .completion_flags = completion_flags_,                              \
            .is_passwd = is_passwd_,                                            \
            .strip_passwd = strip_passwd_,                                      \
            .histname = hname,                                                  \
            .result = res                                                       \
        }                                                                       \
    }                                                                           \
}

#define QUICK_LABEL(txt, id_)                                                   \
{                                                                               \
    .widget_type = quick_label,                                                 \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .label = {                                                              \
            .text = txt,                                                        \
            .input = NULL                                                       \
        }                                                                       \
    }                                                                           \
}

#define QUICK_RADIO(cnt, items_, val, id_)                                      \
{                                                                               \
    .widget_type = quick_radio,                                                 \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = id_,                                                                  \
    .u = {                                                                      \
        .radio = {                                                              \
            .count = cnt,                                                       \
            .items = items_,                                                    \
            .value = val                                                        \
        }                                                                       \
    }                                                                           \
}

#define QUICK_START_GROUPBOX(t)                                                 \
{                                                                               \
    .widget_type = quick_start_groupbox,                                        \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .groupbox = {                                                           \
            .title = t                                                          \
        }                                                                       \
    }                                                                           \
}

#define QUICK_STOP_GROUPBOX                                                     \
{                                                                               \
    .widget_type = quick_stop_groupbox,                                         \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .input = {                                                              \
            .text = NULL,                                                       \
            .histname = NULL,                                                   \
            .result = NULL                                                      \
        }                                                                       \
    }                                                                           \
}

#define QUICK_SEPARATOR(line_)                                                  \
{                                                                               \
    .widget_type = quick_separator,                                             \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .separator = {                                                          \
            .space = TRUE,                                                      \
            .line = line_                                                       \
        }                                                                       \
    }                                                                           \
}

#define QUICK_START_COLUMNS                                                     \
{                                                                               \
    .widget_type = quick_start_columns,                                         \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .input = {                                                              \
            .text = NULL,                                                       \
            .histname = NULL,                                                   \
            .result = NULL                                                      \
        }                                                                       \
    }                                                                           \
}

#define QUICK_NEXT_COLUMN                                                       \
{                                                                               \
    .widget_type = quick_next_column,                                           \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .input = {                                                              \
            .text = NULL,                                                       \
            .histname = NULL,                                                   \
            .result = NULL                                                      \
        }                                                                       \
    }                                                                           \
}

#define QUICK_STOP_COLUMNS                                                      \
{                                                                               \
    .widget_type = quick_stop_columns,                                          \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .input = {                                                              \
            .text = NULL,                                                       \
            .histname = NULL,                                                   \
            .result = NULL                                                      \
        }                                                                       \
    }                                                                           \
}

#define QUICK_START_BUTTONS(space_, line_)                                      \
{                                                                               \
    .widget_type = quick_buttons,                                               \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .separator = {                                                          \
            .space = space_,                                                    \
            .line = line_                                                       \
        }                                                                       \
    }                                                                           \
}

#define QUICK_BUTTONS_OK_CANCEL                                                 \
    QUICK_START_BUTTONS (TRUE, TRUE),                                           \
        QUICK_BUTTON (N_("&OK"), B_ENTER, NULL, NULL),                          \
        QUICK_BUTTON (N_("&Cancel"), B_CANCEL, NULL, NULL)

#define QUICK_END                                                               \
{                                                                               \
    .widget_type = quick_end,                                                   \
    .options = WOP_DEFAULT,                                                     \
    .pos_flags = WPOS_KEEP_DEFAULT,                                             \
    .id = NULL,                                                                 \
    .u = {                                                                      \
        .input = {                                                              \
            .text = NULL,                                                       \
            .histname = NULL,                                                   \
            .result = NULL                                                      \
        }                                                                       \
    }                                                                           \
}

/*** enums ***************************************************************************************/

/* Quick Widgets */
typedef enum
{
    quick_end = 0,
    quick_checkbox = 1,
    quick_button = 2,
    quick_input = 3,
    quick_label = 4,
    quick_radio = 5,
    quick_start_groupbox = 6,
    quick_stop_groupbox = 7,
    quick_separator = 8,
    quick_start_columns = 9,
    quick_next_column = 10,
    quick_stop_columns = 11,
    quick_buttons = 12
} quick_t;

typedef enum
{
    input_label_none = 0,
    input_label_above = 1,
    input_label_left = 2,
    input_label_right = 3,
    input_label_below = 4
} quick_input_label_location_t;

/*** structures declarations (and typedefs of structures)*****************************************/

/* The widget is placed on relative_?/divisions_? of the parent widget */
typedef struct quick_widget_t quick_widget_t;

struct quick_widget_t
{
    quick_t widget_type;

    widget_options_t options;
    widget_state_t state;
    widget_pos_flags_t pos_flags;
    unsigned long *id;

    /* widget parameters */
    union
    {
        struct
        {
            const char *text;
            gboolean *state;    /* in/out */
        } checkbox;

        struct
        {
            const char *text;
            int action;
            bcback_fn callback;
        } button;

        struct
        {
            const char *label_text;
            quick_input_label_location_t label_location;
            quick_widget_t *label;
            const char *text;
            input_complete_t completion_flags;
            gboolean is_passwd; /* TRUE -- is password */
            gboolean strip_passwd;
            const char *histname;
            char **result;
        } input;

        struct
        {
            const char *text;
            quick_widget_t *input;
        } label;

        struct
        {
            int count;
            const char **items;
            int *value;         /* in/out */
        } radio;

        struct
        {
            const char *title;
        } groupbox;

        struct
        {
            gboolean space;
            gboolean line;
        } separator;
    } u;
};

typedef struct
{
    WRect rect;                 /* if rect.x == -1 or rect.y == -1, then dialog is ceneterd;
                                 * rect.lines is unused and ignored */
    const char *title;
    const char *help;
    quick_widget_t *widgets;
    widget_cb_fn callback;
    widget_mouse_cb_fn mouse_callback;
} quick_dialog_t;

/*** global variables defined in .c file *********************************************************/

/*** declarations of public functions ************************************************************/

int quick_dialog_skip (quick_dialog_t * quick_dlg, int nskip);

/*** inline functions ****************************************************************************/

static inline int
quick_dialog (quick_dialog_t *quick_dlg)
{
    return quick_dialog_skip (quick_dlg, 1);
}

#endif /* MC__QUICK_H */