2 * $Id: menubox.c,v 1.148 2013/09/02 17:15:13 tom Exp $
4 * menubox.c -- implements the menu box
6 * Copyright 2000-2012,2013 Thomas E. Dickey
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.
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.
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.
23 * An earlier version of this program lists as authors
24 * Savio Lam (lam836@cs.cuhk.hk)
37 /* the outer-window */
45 /* the inner-window */
47 DIALOG_LISTITEM *items;
51 #define MIN_HIGH (1 + (5 * MARGIN))
53 #define INPUT_ROWS 3 /* rows per inputmenu entry */
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))
63 print_item(ALL_DATA * data,
65 DIALOG_LISTITEM * item,
70 chtype save = dlg_get_attrs(win);
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);
79 const char *show = (dialog_vars.no_items
89 bordchar = item_selected_attr;
92 bordchar = dialog_attr;
96 /* Clear 'residue' of last item and mark current current item */
98 (void) wattrset(win, (selected != Unselected) ? item_selected_attr : item_attr);
99 for (n = my_y - 1; n < my_y + INPUT_ROWS - 1; n++) {
101 wprintw(win, "%*s", my_width, " ");
104 (void) wattrset(win, menubox_attr);
106 wprintw(win, "%*s", my_width, " ");
109 /* highlight first char of the tag to be special */
111 (void) wmove(win, my_y, data->tag_x);
112 dlg_print_listitem(win, item->name, climit, first, selected);
116 /* Draw the input field box (only for inputmenu) */
117 (void) wmove(win, my_y, my_x);
120 dlg_draw_box(win, my_y - 1, my_x, INPUT_ROWS, my_width - my_x - data->tag_x,
127 /* print actual item */
128 wmove(win, my_y, my_x);
129 dlg_print_listitem(win, show, my_width - my_x, first, selected);
132 dlg_item_help(item->help);
134 (void) wattrset(win, save);
138 * Allow the user to edit the text of a menu entry.
141 input_menu_edit(ALL_DATA * data,
142 DIALOG_LISTITEM * items,
146 chtype save = dlg_get_attrs(data->menu);
149 int key = 0, fkey = 0;
152 bool is_inputmenu = TRUE;
153 int y = ItemToRow(choice);
155 int max_len = dlg_max_input(MAX((int) strlen(items->text) + 1, MAX_LEN));
157 result = dlg_malloc(char, (size_t) max_len);
158 assert_ptr(result, "input_menu_edit");
160 /* original item is used to initialize the input string. */
162 strcpy(result, items->text);
164 print_item(data, data->menu, items, choice, Editing, TRUE);
166 /* taken out of inputbox.c - but somewhat modified */
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,
174 data->menu_width - data->item_x - 3,
177 } else if (key == ESC || key == TAB) {
184 print_item(data, data->menu, items, choice, Selected, TRUE);
185 (void) wattrset(data->menu, save);
192 handle_button(int code, DIALOG_LISTITEM * items, int choice)
197 case DLG_EXIT_OK: /* FALLTHRU */
199 dlg_add_string(items[choice].name);
202 dlg_add_help_listitem(&code, &help_result, &items[choice]);
203 dlg_add_string(help_result);
210 dlg_renamed_menutext(DIALOG_LISTITEM * items, int current, char *newtext)
212 if (dialog_vars.input_result)
213 dialog_vars.input_result[0] = '\0';
214 dlg_add_result("RENAMED ");
215 dlg_add_string(items[current].name);
217 dlg_add_string(newtext);
218 return DLG_EXIT_EXTRA;
222 dlg_dummy_menutext(DIALOG_LISTITEM * items, int current, char *newtext)
227 return DLG_EXIT_ERROR;
231 print_menu(ALL_DATA * data, int choice, int scrollamt, int max_choice, bool is_inputmenu)
235 for (i = 0; i < max_choice; i++) {
238 &data->items[i + scrollamt],
240 (i == choice) ? Selected : Unselected,
244 /* Clean bottom lines */
246 int spare_lines, x_count;
247 spare_lines = data->menu_height % INPUT_ROWS;
248 (void) wattrset(data->menu, menubox_attr);
249 for (; spare_lines; spare_lines--) {
250 wmove(data->menu, data->menu_height - spare_lines, 0);
251 for (x_count = 0; x_count < data->menu_width;
253 waddch(data->menu, ' ');
258 (void) wnoutrefresh(data->menu);
260 dlg_draw_scrollbar(data->dialog,
263 scrollamt + max_choice,
266 data->box_x + data->menu_width,
268 data->box_y + data->menu_height + 1,
269 menubox_border2_attr,
270 menubox_border_attr);
274 check_hotkey(DIALOG_LISTITEM * items, int choice)
278 if (dlg_match_char(dlg_last_getc(),
281 : items[choice].name))) {
288 * This is an alternate interface to 'menu' which allows the application
289 * to read the list item states back directly without putting them in the
293 dlg_menu(const char *title,
299 DIALOG_LISTITEM * items,
301 DIALOG_INPUTMENU rename_menutext)
304 static DLG_KEYS_BINDING binding[] = {
307 DLG_KEYS_DATA( DLGK_FIELD_NEXT, ' ' ),
308 DLG_KEYS_DATA( DLGK_FIELD_NEXT, KEY_RIGHT ),
309 DLG_KEYS_DATA( DLGK_FIELD_NEXT, TAB ),
310 DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_BTAB ),
311 DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_LEFT ),
312 DLG_KEYS_DATA( DLGK_ITEM_NEXT, '+' ),
313 DLG_KEYS_DATA( DLGK_ITEM_NEXT, KEY_DOWN ),
314 DLG_KEYS_DATA( DLGK_ITEM_NEXT, CHR_NEXT ),
315 DLG_KEYS_DATA( DLGK_ITEM_PREV, '-' ),
316 DLG_KEYS_DATA( DLGK_ITEM_PREV, KEY_UP ),
317 DLG_KEYS_DATA( DLGK_ITEM_PREV, CHR_PREVIOUS ),
318 DLG_KEYS_DATA( DLGK_PAGE_FIRST, KEY_HOME ),
319 DLG_KEYS_DATA( DLGK_PAGE_LAST, KEY_END ),
320 DLG_KEYS_DATA( DLGK_PAGE_LAST, KEY_LL ),
321 DLG_KEYS_DATA( DLGK_PAGE_NEXT, KEY_NPAGE ),
322 DLG_KEYS_DATA( DLGK_PAGE_PREV, KEY_PPAGE ),
325 static DLG_KEYS_BINDING binding2[] = {
334 int old_height = height;
335 int old_width = width;
338 int i, j, x, y, cur_x, cur_y;
340 int button = dialog_state.visit_items ? -1 : dlg_default_button();
341 int choice = dlg_default_listitem(items);
342 int result = DLG_EXIT_UNKNOWN;
346 int use_width, name_width, text_width, list_width;
347 WINDOW *dialog, *menu;
348 char *prompt = dlg_strclone(cprompt);
349 const char **buttons = dlg_ok_labels();
350 bool is_inputmenu = ((rename_menutext != 0)
351 && (rename_menutext != dlg_dummy_menutext));
354 all.item_no = item_no;
357 dlg_tab_correct_str(prompt);
363 all.menu_height = menu_height;
364 use_width = dlg_calc_list_width(item_no, items) + 10;
365 use_width = MAX(26, use_width);
366 if (all.menu_height == 0) {
367 /* calculate height without items (4) */
368 dlg_auto_size(title, prompt, &height, &width, MIN_HIGH, use_width);
369 dlg_calc_listh(&height, &all.menu_height, item_no);
371 dlg_auto_size(title, prompt,
373 MIN_HIGH + all.menu_height, use_width);
375 dlg_button_layout(buttons, &width);
376 dlg_print_size(height, width);
377 dlg_ctl_size(height, width);
379 x = dlg_box_x_ordinate(width);
380 y = dlg_box_y_ordinate(height);
382 dialog = dlg_new_window(height, width, y, x);
385 dlg_register_window(dialog, "menubox", binding);
386 dlg_register_buttons(dialog, "menubox", buttons);
388 dlg_mouse_setbase(x, y);
390 dlg_draw_box2(dialog, 0, 0, height, width, dialog_attr, border_attr, border2_attr);
391 dlg_draw_bottom_box2(dialog, border_attr, border2_attr, dialog_attr);
392 dlg_draw_title(dialog, title);
394 (void) wattrset(dialog, dialog_attr);
395 dlg_print_autowrap(dialog, prompt, height, width);
397 all.menu_width = width - 6;
398 getyx(dialog, cur_y, cur_x);
399 all.box_y = cur_y + 1;
400 all.box_x = (width - all.menu_width) / 2 - 1;
403 * After displaying the prompt, we know how much space we really have.
404 * Limit the list to avoid overwriting the ok-button.
406 if (all.menu_height + MIN_HIGH > height - cur_y)
407 all.menu_height = height - MIN_HIGH - cur_y;
408 if (all.menu_height <= 0)
411 /* Find out maximal number of displayable items at once. */
412 max_choice = MIN(all.menu_height,
415 max_choice /= INPUT_ROWS;
417 /* create new window for the menu */
418 menu = dlg_sub_window(dialog, all.menu_height, all.menu_width,
423 dlg_register_window(menu, "menu", binding2);
424 dlg_register_buttons(menu, "menu", buttons);
426 /* draw a box around the menu items */
428 all.box_y, all.box_x,
429 all.menu_height + 2, all.menu_width + 2,
430 menubox_border_attr, menubox_border2_attr);
435 /* Find length of longest item to center menu *
436 * only if --menu was given, using --inputmenu *
437 * won't be centered. */
438 for (i = 0; i < item_no; i++) {
439 name_width = MAX(name_width, dlg_count_columns(items[i].name));
440 text_width = MAX(text_width, dlg_count_columns(items[i].text));
443 /* If the name+text is wider than the list is allowed, then truncate
444 * one or both of them. If the name is no wider than 30% of the list,
447 * FIXME: the gutter width and name/list ratio should be configurable.
449 use_width = (all.menu_width - GUTTER);
450 if (dialog_vars.no_tags) {
451 list_width = MIN(use_width, text_width);
452 } else if (dialog_vars.no_items) {
453 list_width = MIN(use_width, name_width);
458 && text_width + name_width > use_width) {
459 int need = (int) (0.30 * use_width);
460 if (name_width > need) {
461 int want = (int) (use_width
462 * ((double) name_width)
463 / (text_width + name_width));
464 name_width = (want > need) ? want : need;
466 text_width = use_width - name_width;
468 list_width = (text_width + name_width);
471 all.tag_x = (is_inputmenu
473 : (use_width - list_width) / 2);
474 all.item_x = ((dialog_vars.no_tags
476 : (dialog_vars.no_items
478 : (GUTTER + name_width)))
481 if (choice - scrollamt >= max_choice) {
482 scrollamt = choice - (max_choice - 1);
483 choice = max_choice - 1;
486 print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
488 /* register the new window, along with its borders */
489 dlg_mouse_mkbigregion(all.box_y + 1, all.box_x,
490 all.menu_height + 2, all.menu_width + 2,
491 KEY_MAX, 1, 1, 1 /* by lines */ );
493 dlg_draw_buttons(dialog, height - 2, 0, buttons, button, FALSE, width);
495 dlg_trace_win(dialog);
496 while (result == DLG_EXIT_UNKNOWN) {
497 if (button < 0) /* --visit-items */
499 all.box_y + ItemToRow(choice) + 1,
500 all.box_x + all.tag_x + 1);
502 key = dlg_mouse_wgetch(dialog, &fkey);
503 if (dlg_result_key(key, fkey, &result))
509 * Allow a mouse-click on a box to switch selection to that box.
510 * Handling a button click is a little more complicated, since we
511 * push a KEY_ENTER back onto the input stream so we'll put the
512 * cursor at the right place before handling the "keypress".
514 if (key >= DLGK_MOUSE(KEY_MAX)) {
515 key -= DLGK_MOUSE(KEY_MAX);
517 if (i < max_choice) {
523 } else if (is_DLGK_MOUSE(key)
524 && dlg_ok_buttoncode(key - M_EVENT) >= 0) {
525 button = (key - M_EVENT);
531 * Check if key pressed matches first character of any item tag in
532 * list. If there is more than one match, we will cycle through
533 * each one as the same key is pressed repeatedly.
535 if (button < 0 || !dialog_state.visit_items) {
536 for (j = scrollamt + choice + 1; j < item_no; j++) {
537 if (check_hotkey(items, j)) {
544 for (j = 0; j <= scrollamt + choice; j++) {
545 if (check_hotkey(items, j)) {
554 } else if ((j = dlg_char_to_button(key, buttons)) >= 0) {
561 * A single digit (1-9) positions the selection to that line in the
567 && (key - '1' < max_choice)) {
573 if (!found && fkey) {
576 case DLGK_PAGE_FIRST:
580 i = item_no - 1 - scrollamt;
582 case DLGK_MOUSE(KEY_PPAGE):
586 else if (scrollamt != 0)
587 i = -MIN(scrollamt, max_choice);
591 case DLGK_MOUSE(KEY_NPAGE):
593 i = MIN(choice + max_choice, item_no - scrollamt - 1);
597 if (choice == 0 && scrollamt == 0)
602 if (scrollamt + choice >= item_no - 1)
613 getyx(dialog, cur_y, cur_x);
614 if (i < 0 || i >= max_choice) {
619 choice = max_choice - 1;
620 scrollamt += (i - max_choice + 1);
622 print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
625 print_menu(&all, choice, scrollamt, max_choice, is_inputmenu);
626 (void) wmove(dialog, cur_y, cur_x);
630 continue; /* wait for another key press */
635 case DLGK_FIELD_PREV:
636 button = dlg_prev_button(buttons, button);
637 dlg_draw_buttons(dialog, height - 2, 0, buttons, button,
640 case DLGK_FIELD_NEXT:
641 button = dlg_next_button(buttons, button);
642 dlg_draw_buttons(dialog, height - 2, 0, buttons, button,
647 result = dlg_ok_buttoncode(button);
649 result = dlg_enter_buttoncode(button);
652 * If dlg_menu() is called from dialog_menu(), we want to
653 * capture the results into dialog_vars.input_result.
655 if (result == DLG_EXIT_ERROR) {
656 result = DLG_EXIT_UNKNOWN;
657 } else if (is_inputmenu
658 || rename_menutext == dlg_dummy_menutext) {
659 result = handle_button(result,
665 * If we have a rename_menutext function, interpret the Extra
666 * button as a request to rename the menu's text. If that
667 * function doesn't return "Unknown", we will exit from this
668 * function. Usually that is done for dialog_menu(), so the
669 * shell script can use the updated value. If it does return
670 * "Unknown", update the list item only. A direct caller of
671 * dlg_menu() can free the renamed value - we cannot.
673 if (is_inputmenu && result == DLG_EXIT_EXTRA) {
676 if (input_menu_edit(&all,
677 &items[scrollamt + choice],
680 result = rename_menutext(items, scrollamt + choice, tmp);
681 if (result == DLG_EXIT_UNKNOWN) {
682 items[scrollamt + choice].text = tmp;
687 result = DLG_EXIT_UNKNOWN;
690 &items[scrollamt + choice],
694 (void) wnoutrefresh(menu);
698 if (result == DLG_EXIT_UNKNOWN) {
699 dlg_draw_buttons(dialog, height - 2, 0,
700 buttons, button, FALSE, width);
711 dlg_del_window(dialog);
713 dlg_mouse_free_regions();
723 dlg_mouse_free_regions();
724 dlg_unregister_window(menu);
725 dlg_del_window(dialog);
728 *current_item = scrollamt + choice;
733 * Display a menu for choosing among a number of options
736 dialog_menu(const char *title,
747 DIALOG_LISTITEM *listitems;
749 listitems = dlg_calloc(DIALOG_LISTITEM, (size_t) item_no + 1);
750 assert_ptr(listitems, "dialog_menu");
752 for (i = j = 0; i < item_no; ++i) {
753 listitems[i].name = items[j++];
754 listitems[i].text = (dialog_vars.no_items
757 listitems[i].help = ((dialog_vars.item_help)
761 dlg_align_columns(&listitems[0].text, sizeof(DIALOG_LISTITEM), item_no);
763 result = dlg_menu(title,
771 (dialog_vars.input_menu
772 ? dlg_renamed_menutext
773 : dlg_dummy_menutext));
775 dlg_free_columns(&listitems[0].text, sizeof(DIALOG_LISTITEM), item_no);