src/dialog.h

   1 /* Dialog box features module for the Midnight Commander
   2    Copyright (C) 1994, 1995 Radek Doulik, Miguel de Icaza
   3
   4    This program is free software; you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation; either version 2 of the License, or
   7    (at your option) any later version.
   8
   9    This program is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program; if not, write to the Free Software
  16    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  17  */
  18
  19 /** \file dialog.h
  20  *  \brief Header: dialog box features module
  21  */
  22
  23 #ifndef MC_DIALOG_H
  24 #define MC_DIALOG_H
  25
  26 #include "lib/tty/mouse.h"
  27
  28 /* Common return values */
  29 #define B_EXIT          0
  30 #define B_CANCEL        1
  31 #define B_ENTER         2
  32 #define B_HELP          3
  33 #define B_USER          100
  34
  35 typedef struct Widget Widget;
  36
  37 /* Widget messages */
  38 typedef enum
  39 {
  40     WIDGET_INIT,                /* Initialize widget */
  41     WIDGET_FOCUS,               /* Draw widget in focused state */
  42     WIDGET_UNFOCUS,             /* Draw widget in unfocused state */
  43     WIDGET_DRAW,                /* Sent to widget to draw themselves */
  44     WIDGET_KEY,                 /* Sent to widgets on key press */
  45     WIDGET_HOTKEY,              /* Sent to widget to catch preprocess key */
  46     WIDGET_COMMAND,             /* Send to widget to handle command */
  47     WIDGET_DESTROY,             /* Sent to widget at destruction time */
  48     WIDGET_CURSOR,              /* Sent to widget to position the cursor */
  49     WIDGET_IDLE,                /* Sent to widgets with options & W_WANT_IDLE */
  50     WIDGET_RESIZED              /* Sent after a widget has been resized */
  51 } widget_msg_t;
  52
  53 typedef enum
  54 {
  55     MSG_NOT_HANDLED = 0,
  56     MSG_HANDLED = 1
  57 } cb_ret_t;
  58
  59 /* Widgets are expected to answer to the following messages:
  60
  61    WIDGET_FOCUS:   1 if the accept the focus, 0 if they do not.
  62    WIDGET_UNFOCUS: 1 if they accept to release the focus, 0 if they don't.
  63    WIDGET_KEY:     1 if they actually used the key, 0 if not.
  64    WIDGET_HOTKEY:  1 if they actually used the key, 0 if not.
  65  */
  66
  67 /* Dialog messages */
  68 typedef enum
  69 {
  70     DLG_INIT = 0,               /* Initialize dialog */
  71     DLG_IDLE = 1,               /* The idle state is active */
  72     DLG_DRAW = 2,               /* Draw dialog on screen */
  73     DLG_FOCUS = 3,              /* A widget has got focus */
  74     DLG_UNFOCUS = 4,            /* A widget has been unfocused */
  75     DLG_RESIZE = 5,             /* Window size has changed */
  76     DLG_KEY = 6,                /* Key before sending to widget */
  77     DLG_HOTKEY_HANDLED = 7,     /* A widget has got the hotkey */
  78     DLG_POST_KEY = 8,           /* The key has been handled */
  79     DLG_UNHANDLED_KEY = 9,      /* Key that no widget handled */
  80     DLG_ACTION = 10,            /* State of check- and radioboxes has changed
  81                                  * and listbox current entry has changed */
  82     DLG_VALIDATE = 11,          /* Dialog is to be closed */
  83     DLG_END = 12                /* Shut down dialog */
  84 } dlg_msg_t;
  85
  86
  87 /* Dialog callback */
  88 typedef struct Dlg_head Dlg_head;
  89 typedef cb_ret_t (*dlg_cb_fn) (struct Dlg_head * h, Widget * sender,
  90                                dlg_msg_t msg, int parm, void *data);
  91
  92 /* get string representation of shortcut assigned  with command */
  93 /* as menu is a widget of dialog, ask dialog about shortcut string */
  94 typedef char *(*dlg_shortcut_str) (unsigned long command);
  95
  96 /* Dialog color constants */
  97 #define DLG_COLOR_NUM       4
  98 #define DLG_NORMALC(h)      ((h)->color[0])
  99 #define DLG_FOCUSC(h)       ((h)->color[1])
 100 #define DLG_HOT_NORMALC(h)  ((h)->color[2])
 101 #define DLG_HOT_FOCUSC(h)   ((h)->color[3])
 102
 103 struct Dlg_head
 104 {
 105     /* Set by the user */
 106     int flags;                  /* User flags */
 107     const char *help_ctx;       /* Name of the help entry */
 108     int *color;                 /* Color set. Unused in viewer and editor */
 109                                 /*notconst */ char *title;
 110                                 /* Title of the dialog */
 111
 112     /* Set and received by the user */
 113     int ret_value;              /* Result of run_dlg() */
 114
 115     /* Geometry */
 116     int x, y;                   /* Position relative to screen origin */
 117     int cols, lines;            /* Width and height of the window */
 118
 119     /* Internal flags */
 120     unsigned int running:1;     /* The dialog is currently active */
 121     unsigned int fullscreen:1;  /* Parents dialogs don't need refresh */
 122     int mouse_status;           /* For the autorepeat status of the mouse */
 123
 124     /* Internal variables */
 125     int count;                  /* Number of widgets */
 126     struct Widget *current;     /* Curently active widget */
 127     void *data;                 /* Data can be passed to dialog */
 128     dlg_cb_fn callback;
 129     dlg_shortcut_str get_shortcut;      /* Shortcut string */
 130     struct Dlg_head *parent;    /* Parent dialog */
 131 };
 132
 133 /* Color styles for normal and error dialogs */
 134 extern int dialog_colors[4];
 135 extern int alarm_colors[4];
 136
 137
 138 /* Widget callback */
 139 typedef cb_ret_t (*callback_fn) (Widget * widget, widget_msg_t msg, int parm);
 140
 141 /* widget options */
 142 typedef enum
 143 {
 144     W_WANT_HOTKEY = (1 << 1),
 145     W_WANT_CURSOR = (1 << 2),
 146     W_WANT_IDLE = (1 << 3),
 147     W_IS_INPUT = (1 << 4)
 148 } widget_options_t;
 149
 150 /* Flags for widget repositioning on dialog resize */
 151 typedef enum
 152 {
 153     WPOS_KEEP_LEFT = (1 << 0),  /* keep widget distance to left border of dialog */
 154     WPOS_KEEP_RIGHT = (1 << 1), /* keep widget distance to right border of dialog */
 155     WPOS_KEEP_TOP = (1 << 2),   /* keep widget distance to top border of dialog */
 156     WPOS_KEEP_BOTTOM = (1 << 3),        /* keep widget distance to bottom border of dialog */
 157     WPOS_KEEP_HORZ = WPOS_KEEP_LEFT | WPOS_KEEP_RIGHT,
 158     WPOS_KEEP_VERT = WPOS_KEEP_TOP | WPOS_KEEP_BOTTOM,
 159     WPOS_KEEP_ALL = WPOS_KEEP_HORZ | WPOS_KEEP_VERT
 160 } widget_pos_flags_t;
 161
 162 /* Every Widget must have this as its first element */
 163 struct Widget
 164 {
 165     int x, y;
 166     int cols, lines;
 167     widget_options_t options;
 168     widget_pos_flags_t pos_flags;       /* repositioning flags */
 169     int dlg_id;                 /* Number of the widget, starting with 0 */
 170     struct Widget *next;
 171     struct Widget *prev;
 172     callback_fn callback;
 173     mouse_h mouse;
 174     struct Dlg_head *parent;
 175 };
 176
 177 /* draw box in window */
 178 void draw_box (Dlg_head * h, int y, int x, int ys, int xs, gboolean single);
 179
 180 /* Flags for create_dlg: */
 181 #define DLG_REVERSE    (1 << 5)        /* Tab order is opposite to the add order */
 182 #define DLG_WANT_TAB   (1 << 4)        /* Should the tab key be sent to the dialog? */
 183 #define DLG_WANT_IDLE  (1 << 3)        /* Dialog wants idle events */
 184 #define DLG_COMPACT    (1 << 2)        /* Suppress spaces around the frame */
 185 #define DLG_TRYUP      (1 << 1)        /* Try to move two lines up the dialog */
 186 #define DLG_CENTER     (1 << 0)        /* Center the dialog */
 187 #define DLG_NONE       (000000)        /* No options */
 188
 189 /* Creates a dialog head  */
 190 Dlg_head *create_dlg (int y1, int x1, int lines, int cols,
 191                       const int *colors, dlg_cb_fn callback,
 192                       const char *help_ctx, const char *title, int flags);
 193
 194 void dlg_set_default_colors (void);
 195
 196 int add_widget_autopos (Dlg_head * dest, void *w, widget_pos_flags_t pos_flags);
 197 int add_widget (Dlg_head * dest, void *w);
 198
 199 /* sets size of dialog, leaving positioning to automatic mehtods
 200    according to dialog flags */
 201 void dlg_set_size (Dlg_head * h, int lines, int cols);
 202 /* this function allows to set dialog position */
 203 void dlg_set_position (Dlg_head * h, int y1, int x1, int y2, int x2);
 204
 205 /* Runs dialog d */
 206 int run_dlg (Dlg_head * d);
 207
 208 void dlg_run_done (Dlg_head * h);
 209 void dlg_process_event (Dlg_head * h, int key, Gpm_Event * event);
 210 void init_dlg (Dlg_head * h);
 211
 212 /* To activate/deactivate the idle message generation */
 213 void set_idle_proc (Dlg_head * d, int enable);
 214
 215 void dlg_redraw (Dlg_head * h);
 216 void destroy_dlg (Dlg_head * h);
 217
 218 void widget_set_size (Widget * widget, int y, int x, int lines, int cols);
 219
 220 void dlg_broadcast_msg (Dlg_head * h, widget_msg_t message, int reverse);
 221
 222 void init_widget (Widget * w, int y, int x, int lines, int cols,
 223                   callback_fn callback, mouse_h mouse_handler);
 224
 225 /* Default callback for dialogs */
 226 cb_ret_t default_dlg_callback (Dlg_head * h, Widget * sender, dlg_msg_t msg, int parm, void *data);
 227
 228 /* Default paint routine for dialogs */
 229 void common_dialog_repaint (struct Dlg_head *h);
 230
 231 #define widget_move(w, _y, _x) tty_gotoyx (((Widget *)(w))->y + _y, ((Widget *)(w))->x + _x)
 232 #define dlg_move(h, _y, _x) tty_gotoyx (((Dlg_head *)(h))->y + _y, ((Dlg_head *)(h))->x + _x)
 233
 234 extern Dlg_head *current_dlg;
 235
 236 /* A hook list for idle events */
 237 extern Hook *idle_hook;
 238
 239 static inline cb_ret_t
 240 send_message (Widget * w, widget_msg_t msg, int parm)
 241 {
 242     return (*(w->callback)) (w, msg, parm);
 243 }
 244
 245 /* Return 1 if the widget is active, 0 otherwise */
 246 static inline int
 247 dlg_widget_active (void *w)
 248 {
 249     Widget *w1 = (Widget *) w;
 250     return (w1->parent->current == w1);
 251 }
 252
 253 void dlg_replace_widget (Widget * old, Widget * new);
 254 int dlg_overlap (Widget * a, Widget * b);
 255 void widget_erase (Widget *);
 256 void dlg_erase (Dlg_head * h);
 257 void dlg_stop (Dlg_head * h);
 258
 259 /* Widget selection */
 260 void dlg_select_widget (void *widget);
 261 void dlg_one_up (Dlg_head * h);
 262 void dlg_one_down (Dlg_head * h);
 263 int dlg_focus (Dlg_head * h);
 264 Widget *find_widget_type (const Dlg_head * h, callback_fn callback);
 265 void dlg_select_by_id (const Dlg_head * h, int id);
 266
 267 /* Redraw all dialogs */
 268 void do_refresh (void);
 269
 270 /* Sets/clear the specified flag in the options field */
 271 #define widget_option(w,f,i) \
 272     w.options = ((i) ? (w.options | (f)) : (w.options & (~(f))))
 273
 274 #define widget_want_cursor(w,i) widget_option(w, W_WANT_CURSOR, i)
 275 #define widget_want_hotkey(w,i) widget_option(w, W_WANT_HOTKEY, i)
 276
 277 /* Used in load_prompt() */
 278 void update_cursor (Dlg_head * h);
 279
 280 #endif /* MC_DIALOG_H */