4.1 branch.
[dragonfly.git] / contrib / dialog / menubox.c
1 /*
2  *  $Id: menubox.c,v 1.145 2012/12/30 21:11:02 tom Exp $
3  *
4  *  menubox.c -- implements the menu box
5  *
6  *  Copyright 2000-2011,2012    Thomas E. Dickey
7  *
8  *  This program is free software; you can redistribute it and/or modify
9  *  it under the terms of the GNU Lesser General Public Licens, version 2.1e
10  *  as published by the Free Software Foundation.
11  *
12  *  This program is distributed in the hope that it will be useful, but
13  *  WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  *  Lesser General Public License for more details.
16  *
17  *  You should have received a copy of the GNU Lesser General Public
18  *  License along with this program; if not, write to
19  *      Free Software Foundation, Inc.
20  *      51 Franklin St., Fifth Floor
21  *      Boston, MA 02110, USA.
22  *
23  *  An earlier version of this program lists as authors
24  *      Savio Lam (lam836@cs.cuhk.hk)
25  */
26
27 #include <dialog.h>
28 #include <dlg_keys.h>
29
30 typedef enum {
31     Unselected = 0,
32     Selected,
33     Editing
34 } Mode;
35
36 typedef struct {
37     /* the outer-window */
38     WINDOW *dialog;
39     int box_y;
40     int box_x;
41     int tag_x;
42     int item_x;
43     int menu_height;
44     int menu_width;
45     /* the inner-window */
46     WINDOW *menu;
47     DIALOG_LISTITEM *items;
48     int item_no;
49 } ALL_DATA;
50
51 #define MIN_HIGH  (1 + (5 * MARGIN))
52
53 #define INPUT_ROWS     3        /* rows per inputmenu entry */
54
55 #define RowHeight(i) (is_inputmenu ? ((i) * INPUT_ROWS) : ((i) * 1))
56 #define ItemToRow(i) (is_inputmenu ? ((i) * INPUT_ROWS + 1) : (i))
57 #define RowToItem(i) (is_inputmenu ? ((i) / INPUT_ROWS + 0) : (i))
58
59 /*
60  * Print menu item
61  */
62 static void
63 print_item(ALL_DATA * data,
64            WINDOW *win,
65            DIALOG_LISTITEM * item,
66            int choice,
67            Mode selected,
68            bool is_inputmenu)
69 {
70     chtype save = dlg_get_attrs(win);
71     int n;
72     int climit = (data->item_x - data->tag_x - GUTTER);
73     int my_width = data->menu_width;
74     int my_x = data->item_x;
75     int my_y = ItemToRow(choice);
76     bool both = (!dialog_vars.no_tags && !dialog_vars.no_items);
77     bool first = TRUE;
78     chtype bordchar;
79     const char *show = (dialog_vars.no_items
80                         ? item->name
81                         : item->text);
82
83     switch (selected) {
84     default:
85     case Unselected:
86         bordchar = item_attr;
87         break;
88     case Selected:
89         bordchar = item_selected_attr;
90         break;
91     case Editing:
92         bordchar = dialog_attr;
93         break;
94     }
95
96     /* Clear 'residue' of last item and mark current current item */
97     if (is_inputmenu) {
98         (void) wattrset(win, (selected != Unselected) ? item_selected_attr : item_attr);
99         for (n = my_y - 1; n < my_y + INPUT_ROWS - 1; n++) {
100             wmove(win, n, 0);
101             wprintw(win, "%*s", my_width, " ");
102         }
103     } else {
104         (void) wattrset(win, menubox_attr);
105         wmove(win, my_y, 0);
106         wprintw(win, "%*s", my_width, " ");
107     }
108
109     /* highlight first char of the tag to be special */
110     if (both) {
111         (void) wmove(win, my_y, data->tag_x);
112         dlg_print_listitem(win, item->name, climit, first, selected);
113         first = FALSE;
114     }
115
116     /* Draw the input field box (only for inputmenu) */
117     (void) wmove(win, my_y, my_x);
118     if (is_inputmenu) {
119         my_width -= 1;
120         dlg_draw_box(win, my_y - 1, my_x, INPUT_ROWS, my_width - my_x - data->tag_x,
121                      bordchar,
122                      bordchar);
123         my_width -= 1;
124         ++my_x;
125     }
126
127     /* print actual item */
128     wmove(win, my_y, my_x);
129     dlg_print_listitem(win, show, my_width - my_x, first, selected);
130
131     if (selected) {
132         dlg_item_help(item->help);
133     }
134     (void) wattrset(win, save);
135 }
136
137 /*
138  * Allow the user to edit the text of a menu entry.
139  */
140 static int
141 input_menu_edit(ALL_DATA * data,
142                 DIALOG_LISTITEM * items,
143                 int choice,
144                 char **resultp)
145 {
146     chtype save = dlg_get_attrs(data->menu);
147     char *result;
148     int offset = 0;
149     int key = 0, fkey = 0;
150     int first = TRUE;
151     /* see above */
152     bool is_inputmenu = TRUE;
153     int y = ItemToRow(choice);
154     int code = TRUE;
155     int max_len = dlg_max_input(MAX((int) strlen(items->text) + 1, MAX_LEN));
156
157     result = dlg_malloc(char, (size_t) max_len);
158     assert_ptr(result, "input_menu_edit");
159
160     /* original item is used to initialize the input string. */
161     result[0] = '\0';
162     strcpy(result, items->text);
163
164     print_item(data, data->menu, items, choice, Editing, TRUE);
165
166     /* taken out of inputbox.c - but somewhat modified */
167     for (;;) {
168         if (!first)
169             key = dlg_mouse_wgetch(data->menu, &fkey);
170         if (dlg_edit_string(result, &offset, key, fkey, first)) {
171             dlg_show_string(data->menu, result, offset, inputbox_attr,
172                             y,
173                             data->item_x + 1,
174                             data->menu_width - data->item_x - 3,
175                             FALSE, first);
176             first = FALSE;
177         } else if (key == ESC || key == TAB) {
178             code = FALSE;
179             break;
180         } else {
181             break;
182         }
183     }
184     print_item(data, data->menu, items, choice, Selected, TRUE);
185     (void) wattrset(data->menu, save);
186
187     *resultp = result;
188     return code;
189 }
190
191 static int
192 handle_button(int code, DIALOG_LISTITEM * items, int choice)
193 {
194     switch (code) {
195     case DLG_EXIT_OK:           /* FALLTHRU */
196     case DLG_EXIT_EXTRA:
197         dlg_add_string(items[choice].name);
198         break;
199     case DLG_EXIT_HELP:
200         dlg_add_result("HELP ");
201         if (USE_ITEM_HELP(items[choice].help)) {
202             dlg_add_string(items[choice].help);
203             code = DLG_EXIT_ITEM_HELP;
204         } else {
205             dlg_add_string(items[choice].name);
206         }
207         break;
208     }
209     return code;
210 }
211
212 int
213 dlg_renamed_menutext(DIALOG_LISTITEM * items, int current, char *newtext)
214 {
215     if (dialog_vars.input_result)
216         dialog_vars.input_result[0] = '\0';
217     dlg_add_result("RENAMED ");
218     dlg_add_string(items[current].name);
219     dlg_add_result(" ");
220     dlg_add_string(newtext);
221     return DLG_EXIT_EXTRA;
222 }
223
224 int
225 dlg_dummy_menutext(DIALOG_LISTITEM * items, int current, char *newtext)
226 {
227     (void) items;
228     (void) current;
229     (void) newtext;
230     return DLG_EXIT_ERROR;
231 }
232
233 static void
234 print_menu(ALL_DATA * data, int choice, int scrollamt, int max_choice, bool is_inputmenu)
235 {
236     int i;
237
238     for (i = 0; i < max_choice; i++) {
239         print_item(data,
240                    data->menu,
241                    &data->items[i + scrollamt],
242                    i,
243                    (i == choice) ? Selected : Unselected,
244                    is_inputmenu);
245     }
246
247     /* Clean bottom lines */
248     if (is_inputmenu) {
249         int spare_lines, x_count;
250         spare_lines = data->menu_height % INPUT_ROWS;
251         (void) wattrset(data->menu, menubox_attr);
252         for (; spare_lines; spare_lines--) {
253             wmove(data->menu, data->menu_height - spare_lines, 0);
254             for (x_count = 0; x_count < data->menu_width;
255                  x_count++) {
256                 waddch(data->menu, ' ');
257             }
258         }
259     }
260
261     (void) wnoutrefresh(data->menu);
262
263     dlg_draw_scrollbar(data->dialog,
264                        scrollamt,
265                        scrollamt,
266                        scrollamt + max_choice,
267                        data->item_no,
268                        data->box_x,
269                        data->box_x + data->menu_width,
270                        data->box_y,
271                        data->box_y + data->menu_height + 1,
272                        menubox_border2_attr,
273                        menubox_border_attr);
274 }
275
276 static bool
277 check_hotkey(DIALOG_LISTITEM * items, int choice)
278 {
279     bool result = FALSE;
280
281     if (dlg_match_char(dlg_last_getc(),
282                        (dialog_vars.no_tags
283                         ? items[choice].text
284                         : items[choice].name))) {
285         result = TRUE;
286     }
287     return result;
288 }
289
290 /*
291  * This is an alternate interface to 'menu' which allows the application
292  * to read the list item states back directly without putting them in the
293  * output buffer.
294  */
295 int
296 dlg_menu(const char *title,
297          const char *cprompt,
298          int height,
299          int width,
300          int menu_height,
301          int item_no,
302          DIALOG_LISTITEM * items,
303          int *current_item,
304          DIALOG_INPUTMENU rename_menutext)
305 {
306     /* *INDENT-OFF* */
307     static DLG_KEYS_BINDING binding[] = {
308         HELPKEY_BINDINGS,
309         ENTERKEY_BINDINGS,
310         DLG_KEYS_DATA( DLGK_FIELD_NEXT, ' ' ),
311         DLG_KEYS_DATA( DLGK_FIELD_NEXT, KEY_RIGHT ),
312         DLG_KEYS_DATA( DLGK_FIELD_NEXT, TAB ),
313         DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_BTAB ),
314         DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_LEFT ),
315         DLG_KEYS_DATA( DLGK_ITEM_NEXT,  '+' ),
316         DLG_KEYS_DATA( DLGK_ITEM_NEXT,  KEY_DOWN ),
317         DLG_KEYS_DATA( DLGK_ITEM_NEXT,  CHR_NEXT ),
318         DLG_KEYS_DATA( DLGK_ITEM_PREV,  '-' ),
319         DLG_KEYS_DATA( DLGK_ITEM_PREV,  KEY_UP ),
320         DLG_KEYS_DATA( DLGK_ITEM_PREV,  CHR_PREVIOUS ),
321         DLG_KEYS_DATA( DLGK_PAGE_FIRST, KEY_HOME ),
322         DLG_KEYS_DATA( DLGK_PAGE_LAST,  KEY_END ),
323         DLG_KEYS_DATA( DLGK_PAGE_LAST,  KEY_LL ),
324         DLG_KEYS_DATA( DLGK_PAGE_NEXT,  KEY_NPAGE ),
325         DLG_KEYS_DATA( DLGK_PAGE_PREV,  KEY_PPAGE ),
326         END_KEYS_BINDING
327     };
328     static DLG_KEYS_BINDING binding2[] = {
329         INPUTSTR_BINDINGS,
330         HELPKEY_BINDINGS,
331         ENTERKEY_BINDINGS,
332         END_KEYS_BINDING
333     };
334     /* *INDENT-ON* */
335
336 #ifdef KEY_RESIZE
337     int old_height = height;
338     int old_width = width;
339 #endif
340     ALL_DATA all;
341     int i, j, x, y, cur_x, cur_y;
342     int key = 0, fkey;
343     int button = dialog_state.visit_items ? -1 : dlg_default_button();
344     int choice = dlg_default_listitem(items);
345     int result = DLG_EXIT_UNKNOWN;
346     int scrollamt = 0;
347     int max_choice;
348     int found;
349     int use_width, name_width, text_width, list_width;
350     WINDOW *dialog, *menu;
351     char *prompt = dlg_strclone(cprompt);
352     const char **buttons = dlg_ok_labels();
353     bool is_inputmenu = ((rename_menutext != 0)
354                          && (rename_menutext != dlg_dummy_menutext));
355
356     all.items = items;
357     all.item_no = item_no;
358
359     dlg_does_output();
360     dlg_tab_correct_str(prompt);
361
362 #ifdef KEY_RESIZE
363   retry:
364 #endif
365
366     all.menu_height = menu_height;
367     use_width = dlg_calc_list_width(item_no, items) + 10;
368     use_width = MAX(26, use_width);
369     if (all.menu_height == 0) {
370         /* calculate height without items (4) */
371         dlg_auto_size(title, prompt, &height, &width, MIN_HIGH, use_width);
372         dlg_calc_listh(&height, &all.menu_height, item_no);
373     } else {
374         dlg_auto_size(title, prompt,
375                       &height, &width,
376                       MIN_HIGH + all.menu_height, use_width);
377     }
378     dlg_button_layout(buttons, &width);
379     dlg_print_size(height, width);
380     dlg_ctl_size(height, width);
381
382     x = dlg_box_x_ordinate(width);
383     y = dlg_box_y_ordinate(height);
384
385     dialog = dlg_new_window(height, width, y, x);
386     all.dialog = dialog;
387
388     dlg_register_window(dialog, "menubox", binding);
389     dlg_register_buttons(dialog, "menubox", buttons);
390
391     dlg_mouse_setbase(x, y);
392
393     dlg_draw_box2(dialog, 0, 0, height, width, dialog_attr, border_attr, border2_attr);
394     dlg_draw_bottom_box2(dialog, border_attr, border2_attr, dialog_attr);
395     dlg_draw_title(dialog, title);
396
397     (void) wattrset(dialog, dialog_attr);
398     dlg_print_autowrap(dialog, prompt, height, width);
399
400     all.menu_width = width - 6;
401     getyx(dialog, cur_y, cur_x);
402     all.box_y = cur_y + 1;
403     all.box_x = (width - all.menu_width) / 2 - 1;
404
405     /*
406      * After displaying the prompt, we know how much space we really have.
407      * Limit the list to avoid overwriting the ok-button.
408      */
409     if (all.menu_height + MIN_HIGH > height - cur_y)
410         all.menu_height = height - MIN_HIGH - cur_y;
411     if (all.menu_height <= 0)
412         all.menu_height = 1;
413
414     /* Find out maximal number of displayable items at once. */
415     max_choice = MIN(all.menu_height,
416                      RowHeight(item_no));
417     if (is_inputmenu)
418         max_choice /= INPUT_ROWS;
419
420     /* create new window for the menu */
421     menu = dlg_sub_window(dialog, all.menu_height, all.menu_width,
422                           y + all.box_y + 1,
423                           x + all.box_x + 1);
424     all.menu = menu;
425
426     dlg_register_window(menu, "menu", binding2);
427     dlg_register_buttons(menu, "menu", buttons);
428
429     /* draw a box around the menu items */
430     dlg_draw_box(dialog,
431                  all.box_y, all.box_x,
432                  all.menu_height + 2, all.menu_width + 2,
433                  menubox_border_attr, menubox_border2_attr);
434
435     name_width = 0;
436     text_width = 0;
437
438     /* Find length of longest item to center menu  *
439      * only if --menu was given, using --inputmenu *
440      * won't be centered.                         */
441     for (i = 0; i < item_no; i++) {
442         name_width = MAX(name_width, dlg_count_columns(items[i].name));
443         text_width = MAX(text_width, dlg_count_columns(items[i].text));
444     }
445
446     /* If the name+text is wider than the list is allowed, then truncate
447      * one or both of them.  If the name is no wider than 30% of the list,
448      * leave it intact.
449      *
450      * FIXME: the gutter width and name/list ratio should be configurable.
451      */
452     use_width = (all.menu_width - GUTTER);
453     if (dialog_vars.no_tags) {
454         list_width = MIN(use_width, text_width);
455     } else if (dialog_vars.no_items) {
456         list_width = MIN(use_width, name_width);
457     } else {
458         if (text_width >= 0
459             && name_width >= 0
460             && use_width > 0
461             && text_width + name_width > use_width) {
462             int need = (int) (0.30 * use_width);
463             if (name_width > need) {
464                 int want = (int) (use_width
465                                   * ((double) name_width)
466                                   / (text_width + name_width));
467                 name_width = (want > need) ? want : need;
468             }
469             text_width = use_width - name_width;
470         }
471         list_width = (text_width + name_width);
472     }
473
474     all.tag_x = (is_inputmenu
475                  ? 0
476                  : (use_width - list_width) / 2);
477     all.item_x = ((dialog_vars.no_tags
478                    ? 0
479                    : (dialog_vars.no_items
480                       ? 0
481                       : (GUTTER + name_width)))
482                   + all.tag_x);
483
484     if (choice - scrollamt >= max_choice) {
485         scrollamt = choice - (max_choice - 1);
486         choice = max_choice - 1;
487     }
488
489     print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
490
491     /* register the new window, along with its borders */
492     dlg_mouse_mkbigregion(all.box_y + 1, all.box_x,
493                           all.menu_height + 2, all.menu_width + 2,
494                           KEY_MAX, 1, 1, 1 /* by lines */ );
495
496     dlg_draw_buttons(dialog, height - 2, 0, buttons, button, FALSE, width);
497
498     dlg_trace_win(dialog);
499     while (result == DLG_EXIT_UNKNOWN) {
500         if (button < 0)         /* --visit-items */
501             wmove(dialog,
502                   all.box_y + ItemToRow(choice) + 1,
503                   all.box_x + all.tag_x + 1);
504
505         key = dlg_mouse_wgetch(dialog, &fkey);
506         if (dlg_result_key(key, fkey, &result))
507             break;
508
509         found = FALSE;
510         if (fkey) {
511             /*
512              * Allow a mouse-click on a box to switch selection to that box.
513              * Handling a button click is a little more complicated, since we
514              * push a KEY_ENTER back onto the input stream so we'll put the
515              * cursor at the right place before handling the "keypress".
516              */
517             if (key >= DLGK_MOUSE(KEY_MAX)) {
518                 key -= DLGK_MOUSE(KEY_MAX);
519                 i = RowToItem(key);
520                 if (i < max_choice) {
521                     found = TRUE;
522                 } else {
523                     beep();
524                     continue;
525                 }
526             } else if (is_DLGK_MOUSE(key)
527                        && dlg_ok_buttoncode(key - M_EVENT) >= 0) {
528                 button = (key - M_EVENT);
529                 ungetch('\n');
530                 continue;
531             }
532         } else {
533             /*
534              * Check if key pressed matches first character of any item tag in
535              * list.  If there is more than one match, we will cycle through
536              * each one as the same key is pressed repeatedly.
537              */
538             if (button < 0 || !dialog_state.visit_items) {
539                 for (j = scrollamt + choice + 1; j < item_no; j++) {
540                     if (check_hotkey(items, j)) {
541                         found = TRUE;
542                         i = j - scrollamt;
543                         break;
544                     }
545                 }
546                 if (!found) {
547                     for (j = 0; j <= scrollamt + choice; j++) {
548                         if (check_hotkey(items, j)) {
549                             found = TRUE;
550                             i = j - scrollamt;
551                             break;
552                         }
553                     }
554                 }
555                 if (found)
556                     dlg_flush_getc();
557             } else if ((j = dlg_char_to_button(key, buttons)) >= 0) {
558                 button = j;
559                 ungetch('\n');
560                 continue;
561             }
562
563             /*
564              * A single digit (1-9) positions the selection to that line in the
565              * current screen.
566              */
567             if (!found
568                 && (key <= '9')
569                 && (key > '0')
570                 && (key - '1' < max_choice)) {
571                 found = TRUE;
572                 i = key - '1';
573             }
574         }
575
576         if (!found && fkey) {
577             found = TRUE;
578             switch (key) {
579             case DLGK_PAGE_FIRST:
580                 i = -scrollamt;
581                 break;
582             case DLGK_PAGE_LAST:
583                 i = item_no - 1 - scrollamt;
584                 break;
585             case DLGK_MOUSE(KEY_PPAGE):
586             case DLGK_PAGE_PREV:
587                 if (choice)
588                     i = 0;
589                 else if (scrollamt != 0)
590                     i = -MIN(scrollamt, max_choice);
591                 else
592                     continue;
593                 break;
594             case DLGK_MOUSE(KEY_NPAGE):
595             case DLGK_PAGE_NEXT:
596                 i = MIN(choice + max_choice, item_no - scrollamt - 1);
597                 break;
598             case DLGK_ITEM_PREV:
599                 i = choice - 1;
600                 if (choice == 0 && scrollamt == 0)
601                     continue;
602                 break;
603             case DLGK_ITEM_NEXT:
604                 i = choice + 1;
605                 if (scrollamt + choice >= item_no - 1)
606                     continue;
607                 break;
608             default:
609                 found = FALSE;
610                 break;
611             }
612         }
613
614         if (found) {
615             if (i != choice) {
616                 getyx(dialog, cur_y, cur_x);
617                 if (i < 0 || i >= max_choice) {
618                     if (i < 0) {
619                         scrollamt += i;
620                         choice = 0;
621                     } else {
622                         choice = max_choice - 1;
623                         scrollamt += (i - max_choice + 1);
624                     }
625                     print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
626                 } else {
627                     choice = i;
628                     print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
629                     (void) wmove(dialog, cur_y, cur_x);
630                     wrefresh(dialog);
631                 }
632             }
633             continue;           /* wait for another key press */
634         }
635
636         if (fkey) {
637             switch (key) {
638             case DLGK_FIELD_PREV:
639                 button = dlg_prev_button(buttons, button);
640                 dlg_draw_buttons(dialog, height - 2, 0, buttons, button,
641                                  FALSE, width);
642                 break;
643             case DLGK_FIELD_NEXT:
644                 button = dlg_next_button(buttons, button);
645                 dlg_draw_buttons(dialog, height - 2, 0, buttons, button,
646                                  FALSE, width);
647                 break;
648             case DLGK_ENTER:
649                 if (is_inputmenu)
650                     result = dlg_ok_buttoncode(button);
651                 else
652                     result = dlg_enter_buttoncode(button);
653
654                 /*
655                  * If dlg_menu() is called from dialog_menu(), we want to
656                  * capture the results into dialog_vars.input_result.
657                  */
658                 if (result == DLG_EXIT_ERROR) {
659                     result = DLG_EXIT_UNKNOWN;
660                 } else if (is_inputmenu
661                            || rename_menutext == dlg_dummy_menutext) {
662                     result = handle_button(result,
663                                            items,
664                                            scrollamt + choice);
665                 }
666
667                 /*
668                  * If we have a rename_menutext function, interpret the Extra
669                  * button as a request to rename the menu's text.  If that
670                  * function doesn't return "Unknown", we will exit from this
671                  * function.  Usually that is done for dialog_menu(), so the
672                  * shell script can use the updated value.  If it does return
673                  * "Unknown", update the list item only.  A direct caller of
674                  * dlg_menu() can free the renamed value - we cannot.
675                  */
676                 if (is_inputmenu && result == DLG_EXIT_EXTRA) {
677                     char *tmp;
678
679                     if (input_menu_edit(&all,
680                                         &items[scrollamt + choice],
681                                         choice,
682                                         &tmp)) {
683                         result = rename_menutext(items, scrollamt + choice, tmp);
684                         if (result == DLG_EXIT_UNKNOWN) {
685                             items[scrollamt + choice].text = tmp;
686                         } else {
687                             free(tmp);
688                         }
689                     } else {
690                         result = DLG_EXIT_UNKNOWN;
691                         print_item(&all,
692                                    menu,
693                                    &items[scrollamt + choice],
694                                    choice,
695                                    Selected,
696                                    is_inputmenu);
697                         (void) wnoutrefresh(menu);
698                         free(tmp);
699                     }
700
701                     if (result == DLG_EXIT_UNKNOWN) {
702                         dlg_draw_buttons(dialog, height - 2, 0,
703                                          buttons, button, FALSE, width);
704                     }
705                 }
706                 break;
707 #ifdef KEY_RESIZE
708             case KEY_RESIZE:
709                 /* reset data */
710                 height = old_height;
711                 width = old_width;
712                 /* repaint */
713                 dlg_clear();
714                 dlg_del_window(dialog);
715                 refresh();
716                 dlg_mouse_free_regions();
717                 goto retry;
718 #endif
719             default:
720                 flash();
721                 break;
722             }
723         }
724     }
725
726     dlg_mouse_free_regions();
727     dlg_unregister_window(menu);
728     dlg_del_window(dialog);
729     free(prompt);
730
731     *current_item = scrollamt + choice;
732     return result;
733 }
734
735 /*
736  * Display a menu for choosing among a number of options
737  */
738 int
739 dialog_menu(const char *title,
740             const char *cprompt,
741             int height,
742             int width,
743             int menu_height,
744             int item_no,
745             char **items)
746 {
747     int result;
748     int choice;
749     int i, j;
750     DIALOG_LISTITEM *listitems;
751
752     listitems = dlg_calloc(DIALOG_LISTITEM, (size_t) item_no + 1);
753     assert_ptr(listitems, "dialog_menu");
754
755     for (i = j = 0; i < item_no; ++i) {
756         listitems[i].name = items[j++];
757         listitems[i].text = (dialog_vars.no_items
758                              ? dlg_strempty()
759                              : items[j++]);
760         listitems[i].help = ((dialog_vars.item_help)
761                              ? items[j++]
762                              : dlg_strempty());
763     }
764     dlg_align_columns(&listitems[0].text, sizeof(DIALOG_LISTITEM), item_no);
765
766     result = dlg_menu(title,
767                       cprompt,
768                       height,
769                       width,
770                       menu_height,
771                       item_no,
772                       listitems,
773                       &choice,
774                       (dialog_vars.input_menu
775                        ? dlg_renamed_menutext
776                        : dlg_dummy_menutext));
777
778     dlg_free_columns(&listitems[0].text, sizeof(DIALOG_LISTITEM), item_no);
779     free(listitems);
780     return result;
781 }