lib/widget/wtools.c

   1 /*
   2    Widget based utility functions.
   3
   4    Copyright (C) 1994, 1995, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
   5    2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
   6    The Free Software Foundation, Inc.
   7
   8    Authors:
   9    Miguel de Icaza, 1994, 1995, 1996
  10    Radek Doulik, 1994, 1995
  11    Jakub Jelinek, 1995
  12    Andrej Borsenkow, 1995
  13    Andrew Borodin <aborodin@vmail.ru>, 2009, 2010, 2012
  14
  15    This file is part of the Midnight Commander.
  16
  17    The Midnight Commander is free software: you can redistribute it
  18    and/or modify it under the terms of the GNU General Public License as
  19    published by the Free Software Foundation, either version 3 of the License,
  20    or (at your option) any later version.
  21
  22    The Midnight Commander is distributed in the hope that it will be useful,
  23    but WITHOUT ANY WARRANTY; without even the implied warranty of
  24    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  25    GNU General Public License for more details.
  26
  27    You should have received a copy of the GNU General Public License
  28    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  29  */
  30
  31 /** \file wtools.c
  32  *  \brief Source: widget based utility functions
  33  */
  34
  35 #include <config.h>
  36
  37 #include <stdarg.h>
  38 #include <stdlib.h>
  39
  40 #include "lib/global.h"
  41 #include "lib/tty/tty.h"
  42 #include "lib/tty/key.h"        /* tty_getch() */
  43 #include "lib/strutil.h"
  44 #include "lib/util.h"           /* tilde_expand() */
  45 #include "lib/widget.h"
  46 #include "lib/event.h"          /* mc_event_raise() */
  47
  48 /*** global variables ****************************************************************************/
  49
  50 /*** file scope macro definitions ****************************************************************/
  51
  52 /*** file scope type declarations ****************************************************************/
  53
  54 /*** file scope variables ************************************************************************/
  55
  56 static WDialog *last_query_dlg;
  57
  58 static int sel_pos = 0;
  59
  60 /*** file scope functions ************************************************************************/
  61 /* --------------------------------------------------------------------------------------------- */
  62
  63 /** default query callback, used to reposition query */
  64
  65 static cb_ret_t
  66 query_default_callback (Widget * w, Widget * sender, widget_msg_t msg, int parm, void *data)
  67 {
  68     WDialog *h = DIALOG (w);
  69
  70     switch (msg)
  71     {
  72     case MSG_RESIZE:
  73         if ((h->flags & DLG_CENTER) == 0)
  74         {
  75             WDialog *prev_dlg = NULL;
  76             int ypos, xpos;
  77
  78             /* get dialog under h */
  79             if (top_dlg != NULL)
  80             {
  81                 if (top_dlg->data != (void *) h)
  82                     prev_dlg = DIALOG (top_dlg->data);
  83                 else
  84                 {
  85                     GList *p;
  86
  87                     /* Top dialog is current if it is visible.
  88                        Get previous dialog in stack */
  89                     p = g_list_next (top_dlg);
  90                     if (p != NULL)
  91                         prev_dlg = DIALOG (p->data);
  92                 }
  93             }
  94
  95             /* if previous dialog is not fullscreen'd -- overlap it */
  96             if (prev_dlg == NULL || prev_dlg->fullscreen)
  97                 ypos = LINES / 3 - (w->lines - 3) / 2;
  98             else
  99                 ypos = WIDGET (prev_dlg)->y + 2;
 100
 101             xpos = COLS / 2 - w->cols / 2;
 102
 103             /* set position */
 104             dlg_set_position (h, ypos, xpos, ypos + w->lines, xpos + w->cols);
 105
 106             return MSG_HANDLED;
 107         }
 108         /* fallthrough */
 109
 110     default:
 111         return dlg_default_callback (w, sender, msg, parm, data);
 112     }
 113 }
 114
 115 /* --------------------------------------------------------------------------------------------- */
 116 /** Create message dialog */
 117
 118 static struct WDialog *
 119 do_create_message (int flags, const char *title, const char *text)
 120 {
 121     char *p;
 122     WDialog *d;
 123
 124     /* Add empty lines before and after the message */
 125     p = g_strconcat ("\n", text, "\n", (char *) NULL);
 126     query_dialog (title, p, flags, 0);
 127     d = last_query_dlg;
 128
 129     /* do resize before initing and running */
 130     send_message (d, NULL, MSG_RESIZE, 0, NULL);
 131
 132     init_dlg (d);
 133     g_free (p);
 134
 135     return d;
 136 }
 137
 138 /* --------------------------------------------------------------------------------------------- */
 139 /**
 140  * Show message dialog.  Dismiss it when any key is pressed.
 141  * Not safe to call from background.
 142  */
 143
 144 static void
 145 fg_message (int flags, const char *title, const char *text)
 146 {
 147     WDialog *d;
 148
 149     d = do_create_message (flags, title, text);
 150     tty_getch ();
 151     dlg_run_done (d);
 152     destroy_dlg (d);
 153 }
 154
 155
 156 /* --------------------------------------------------------------------------------------------- */
 157 /** Show message box from background */
 158
 159 #ifdef ENABLE_BACKGROUND
 160 static void
 161 bg_message (int dummy, int *flags, char *title, const char *text)
 162 {
 163     (void) dummy;
 164     title = g_strconcat (_("Background process:"), " ", title, (char *) NULL);
 165     fg_message (*flags, title, text);
 166     g_free (title);
 167 }
 168 #endif /* ENABLE_BACKGROUND */
 169
 170 /* --------------------------------------------------------------------------------------------- */
 171
 172 /**
 173  * Show dialog, not background safe.
 174  *
 175  * If the arguments "header" and "text" should be translated,
 176  * that MUST be done by the caller of fg_input_dialog_help().
 177  *
 178  * The argument "history_name" holds the name of a section
 179  * in the history file. Data entered in the input field of
 180  * the dialog box will be stored there.
 181  *
 182  */
 183 static char *
 184 fg_input_dialog_help (const char *header, const char *text, const char *help,
 185                       const char *history_name, const char *def_text, gboolean strip_password,
 186                       input_complete_t completion_flags)
 187 {
 188     char *p_text;
 189     char histname[64] = "inp|";
 190     gboolean is_passwd = FALSE;
 191     char *my_str;
 192     int ret;
 193
 194     /* label text */
 195     p_text = g_strstrip (g_strdup (text));
 196
 197     /* input history */
 198     if (history_name != NULL && *history_name != '\0')
 199         g_strlcpy (histname + 3, history_name, sizeof (histname) - 3);
 200
 201     /* The special value of def_text is used to identify password boxes
 202        and hide characters with "*".  Don't save passwords in history! */
 203     if (def_text == INPUT_PASSWORD)
 204     {
 205         is_passwd = TRUE;
 206         histname[3] = '\0';
 207         def_text = "";
 208     }
 209
 210     {
 211         quick_widget_t quick_widgets[] = {
 212             /* *INDENT-OFF* */
 213             QUICK_LABELED_INPUT (p_text, input_label_above, def_text, histname, &my_str,
 214                                  NULL, is_passwd, strip_password, completion_flags),
 215             QUICK_BUTTONS_OK_CANCEL,
 216             QUICK_END
 217             /* *INDENT-ON* */
 218         };
 219
 220         quick_dialog_t qdlg = {
 221             -1, -1, COLS / 2, header,
 222             help, quick_widgets, NULL, NULL
 223         };
 224
 225         ret = quick_dialog (&qdlg);
 226     }
 227
 228     g_free (p_text);
 229
 230     return (ret != B_CANCEL) ? my_str : NULL;
 231 }
 232
 233 /* --------------------------------------------------------------------------------------------- */
 234
 235 #ifdef ENABLE_BACKGROUND
 236 static int
 237 wtools_parent_call (void *routine, gpointer ctx, int argc, ...)
 238 {
 239     ev_background_parent_call_t event_data;
 240
 241     event_data.routine = routine;
 242     event_data.ctx = ctx;
 243     event_data.argc = argc;
 244     va_start (event_data.ap, argc);
 245     mc_event_raise (MCEVENT_GROUP_CORE, "background_parent_call", (gpointer) & event_data);
 246     va_end (event_data.ap);
 247     return event_data.ret.i;
 248 }
 249
 250 /* --------------------------------------------------------------------------------------------- */
 251
 252 static char *
 253 wtools_parent_call_string (void *routine, int argc, ...)
 254 {
 255     ev_background_parent_call_t event_data;
 256
 257     event_data.routine = routine;
 258     event_data.argc = argc;
 259     va_start (event_data.ap, argc);
 260     mc_event_raise (MCEVENT_GROUP_CORE, "background_parent_call_string", (gpointer) & event_data);
 261     va_end (event_data.ap);
 262     return event_data.ret.s;
 263 }
 264 #endif /* ENABLE_BACKGROUND */
 265
 266 /* --------------------------------------------------------------------------------------------- */
 267 /*** public functions ****************************************************************************/
 268 /* --------------------------------------------------------------------------------------------- */
 269
 270 /** Used to ask questions to the user */
 271 int
 272 query_dialog (const char *header, const char *text, int flags, int count, ...)
 273 {
 274     va_list ap;
 275     WDialog *query_dlg;
 276     WButton *button;
 277     WButton *defbutton = NULL;
 278     int win_len = 0;
 279     int i;
 280     int result = -1;
 281     int cols, lines;
 282     char *cur_name;
 283     const int *query_colors = (flags & D_ERROR) != 0 ? alarm_colors : dialog_colors;
 284     dlg_flags_t dlg_flags = (flags & D_CENTER) != 0 ? (DLG_CENTER | DLG_TRYUP) : DLG_NONE;
 285
 286     if (header == MSG_ERROR)
 287         header = _("Error");
 288
 289     if (count > 0)
 290     {
 291         va_start (ap, count);
 292         for (i = 0; i < count; i++)
 293         {
 294             char *cp = va_arg (ap, char *);
 295             win_len += str_term_width1 (cp) + 6;
 296             if (strchr (cp, '&') != NULL)
 297                 win_len--;
 298         }
 299         va_end (ap);
 300     }
 301
 302     /* count coordinates */
 303     str_msg_term_size (text, &lines, &cols);
 304     cols = 6 + max (win_len, max (str_term_width1 (header), cols));
 305     lines += 4 + (count > 0 ? 2 : 0);
 306
 307     /* prepare dialog */
 308     query_dlg =
 309         create_dlg (TRUE, 0, 0, lines, cols, query_colors, query_default_callback, NULL,
 310                     "[QueryBox]", header, dlg_flags);
 311
 312     if (count > 0)
 313     {
 314         add_widget_autopos (query_dlg, label_new (2, 3, text), WPOS_KEEP_TOP | WPOS_CENTER_HORZ,
 315                             NULL);
 316
 317         add_widget (query_dlg, hline_new (lines - 4, -1, -1));
 318
 319         cols = (cols - win_len - 2) / 2 + 2;
 320         va_start (ap, count);
 321         for (i = 0; i < count; i++)
 322         {
 323             int xpos;
 324
 325             cur_name = va_arg (ap, char *);
 326             xpos = str_term_width1 (cur_name) + 6;
 327             if (strchr (cur_name, '&') != NULL)
 328                 xpos--;
 329
 330             button = button_new (lines - 3, cols, B_USER + i, NORMAL_BUTTON, cur_name, NULL);
 331             add_widget (query_dlg, button);
 332             cols += xpos;
 333             if (i == sel_pos)
 334                 defbutton = button;
 335         }
 336         va_end (ap);
 337
 338         /* do resize before running and selecting any widget */
 339         send_message (query_dlg, NULL, MSG_RESIZE, 0, NULL);
 340
 341         if (defbutton != NULL)
 342             dlg_select_widget (defbutton);
 343
 344         /* run dialog and make result */
 345         switch (run_dlg (query_dlg))
 346         {
 347         case B_CANCEL:
 348             break;
 349         default:
 350             result = query_dlg->ret_value - B_USER;
 351         }
 352
 353         /* free used memory */
 354         destroy_dlg (query_dlg);
 355     }
 356     else
 357     {
 358         add_widget_autopos (query_dlg, label_new (2, 3, text), WPOS_KEEP_TOP | WPOS_CENTER_HORZ,
 359                             NULL);
 360         add_widget (query_dlg, button_new (0, 0, 0, HIDDEN_BUTTON, "-", NULL));
 361         last_query_dlg = query_dlg;
 362     }
 363     sel_pos = 0;
 364     return result;
 365 }
 366
 367 /* --------------------------------------------------------------------------------------------- */
 368
 369 void
 370 query_set_sel (int new_sel)
 371 {
 372     sel_pos = new_sel;
 373 }
 374
 375 /* --------------------------------------------------------------------------------------------- */
 376 /**
 377  * Create message dialog.  The caller must call dlg_run_done() and
 378  * destroy_dlg() to dismiss it.  Not safe to call from background.
 379  */
 380
 381 struct WDialog *
 382 create_message (int flags, const char *title, const char *text, ...)
 383 {
 384     va_list args;
 385     WDialog *d;
 386     char *p;
 387
 388     va_start (args, text);
 389     p = g_strdup_vprintf (text, args);
 390     va_end (args);
 391
 392     d = do_create_message (flags, title, p);
 393     g_free (p);
 394
 395     return d;
 396 }
 397
 398 /* --------------------------------------------------------------------------------------------- */
 399 /** Show message box, background safe */
 400
 401 void
 402 message (int flags, const char *title, const char *text, ...)
 403 {
 404     char *p;
 405     va_list ap;
 406
 407     va_start (ap, text);
 408     p = g_strdup_vprintf (text, ap);
 409     va_end (ap);
 410
 411     if (title == MSG_ERROR)
 412         title = _("Error");
 413
 414 #ifdef ENABLE_BACKGROUND
 415     if (mc_global.we_are_background)
 416     {
 417         union
 418         {
 419             void *p;
 420             void (*f) (int, int *, char *, const char *);
 421         } func;
 422         func.f = bg_message;
 423
 424         wtools_parent_call (func.p, NULL, 3, sizeof (flags), &flags, strlen (title), title,
 425                             strlen (p), p);
 426     }
 427     else
 428 #endif /* ENABLE_BACKGROUND */
 429         fg_message (flags, title, p);
 430
 431     g_free (p);
 432 }
 433
 434 /* --------------------------------------------------------------------------------------------- */
 435 /**
 436  * Show input dialog, background safe.
 437  *
 438  * If the arguments "header" and "text" should be translated,
 439  * that MUST be done by the caller of these wrappers.
 440  */
 441
 442 char *
 443 input_dialog_help (const char *header, const char *text, const char *help,
 444                    const char *history_name, const char *def_text, gboolean strip_password,
 445                    input_complete_t completion_flags)
 446 {
 447 #ifdef ENABLE_BACKGROUND
 448     if (mc_global.we_are_background)
 449     {
 450         union
 451         {
 452             void *p;
 453             char *(*f) (const char *, const char *, const char *, const char *, const char *,
 454                         gboolean, input_complete_t);
 455         } func;
 456         func.f = fg_input_dialog_help;
 457         return wtools_parent_call_string (func.p, 7,
 458                                           strlen (header), header, strlen (text),
 459                                           text, strlen (help), help,
 460                                           strlen (history_name), history_name,
 461                                           strlen (def_text), def_text,
 462                                           sizeof (gboolean), strip_password,
 463                                           sizeof (input_complete_t), completion_flags);
 464     }
 465     else
 466 #endif /* ENABLE_BACKGROUND */
 467         return fg_input_dialog_help (header, text, help, history_name, def_text, strip_password,
 468                                      completion_flags);
 469 }
 470
 471 /* --------------------------------------------------------------------------------------------- */
 472 /** Show input dialog with default help, background safe */
 473
 474 char *
 475 input_dialog (const char *header, const char *text, const char *history_name, const char *def_text,
 476               input_complete_t completion_flags)
 477 {
 478     return input_dialog_help (header, text, "[Input Line Keys]", history_name, def_text, FALSE,
 479                               completion_flags);
 480 }
 481
 482 /* --------------------------------------------------------------------------------------------- */
 483
 484 char *
 485 input_expand_dialog (const char *header, const char *text,
 486                      const char *history_name, const char *def_text,
 487                      input_complete_t completion_flags)
 488 {
 489     char *result;
 490     char *expanded;
 491
 492     result = input_dialog (header, text, history_name, def_text, completion_flags);
 493     if (result)
 494     {
 495         expanded = tilde_expand (result);
 496         g_free (result);
 497         return expanded;
 498     }
 499     return result;
 500 }
 501
 502 /* --------------------------------------------------------------------------------------------- */