dialog.h 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244
  1. /* SPDX-License-Identifier: GPL-2.0+ */
  2. /*
  3. * dialog.h -- common declarations for all dialog modules
  4. *
  5. * AUTHOR: Savio Lam (lam836@cs.cuhk.hk)
  6. */
  7. #include <sys/types.h>
  8. #include <fcntl.h>
  9. #include <unistd.h>
  10. #include <ctype.h>
  11. #include <stdlib.h>
  12. #include <string.h>
  13. #include <stdbool.h>
  14. #ifndef KBUILD_NO_NLS
  15. # include <libintl.h>
  16. #else
  17. # define gettext(Msgid) ((const char *) (Msgid))
  18. #endif
  19. #ifdef __sun__
  20. #define CURS_MACROS
  21. #endif
  22. #include CURSES_LOC
  23. /*
  24. * Colors in ncurses 1.9.9e do not work properly since foreground and
  25. * background colors are OR'd rather than separately masked. This version
  26. * of dialog was hacked to work with ncurses 1.9.9e, making it incompatible
  27. * with standard curses. The simplest fix (to make this work with standard
  28. * curses) uses the wbkgdset() function, not used in the original hack.
  29. * Turn it off if we're building with 1.9.9e, since it just confuses things.
  30. */
  31. #if defined(NCURSES_VERSION) && defined(_NEED_WRAP) && !defined(GCC_PRINTFLIKE)
  32. #define OLD_NCURSES 1
  33. #undef wbkgdset
  34. #define wbkgdset(w,p) /*nothing */
  35. #else
  36. #define OLD_NCURSES 0
  37. #endif
  38. #define TR(params) _tracef params
  39. #define KEY_ESC 27
  40. #define TAB 9
  41. #define MAX_LEN 2048
  42. #define BUF_SIZE (10*1024)
  43. #define MIN(x,y) (x < y ? x : y)
  44. #define MAX(x,y) (x > y ? x : y)
  45. #ifndef ACS_ULCORNER
  46. #define ACS_ULCORNER '+'
  47. #endif
  48. #ifndef ACS_LLCORNER
  49. #define ACS_LLCORNER '+'
  50. #endif
  51. #ifndef ACS_URCORNER
  52. #define ACS_URCORNER '+'
  53. #endif
  54. #ifndef ACS_LRCORNER
  55. #define ACS_LRCORNER '+'
  56. #endif
  57. #ifndef ACS_HLINE
  58. #define ACS_HLINE '-'
  59. #endif
  60. #ifndef ACS_VLINE
  61. #define ACS_VLINE '|'
  62. #endif
  63. #ifndef ACS_LTEE
  64. #define ACS_LTEE '+'
  65. #endif
  66. #ifndef ACS_RTEE
  67. #define ACS_RTEE '+'
  68. #endif
  69. #ifndef ACS_UARROW
  70. #define ACS_UARROW '^'
  71. #endif
  72. #ifndef ACS_DARROW
  73. #define ACS_DARROW 'v'
  74. #endif
  75. /* error return codes */
  76. #define ERRDISPLAYTOOSMALL (KEY_MAX + 1)
  77. /*
  78. * Color definitions
  79. */
  80. struct dialog_color {
  81. chtype atr; /* Color attribute */
  82. int fg; /* foreground */
  83. int bg; /* background */
  84. int hl; /* highlight this item */
  85. };
  86. struct subtitle_list {
  87. struct subtitle_list *next;
  88. const char *text;
  89. };
  90. struct dialog_info {
  91. const char *backtitle;
  92. struct subtitle_list *subtitles;
  93. struct dialog_color screen;
  94. struct dialog_color shadow;
  95. struct dialog_color dialog;
  96. struct dialog_color title;
  97. struct dialog_color border;
  98. struct dialog_color button_active;
  99. struct dialog_color button_inactive;
  100. struct dialog_color button_key_active;
  101. struct dialog_color button_key_inactive;
  102. struct dialog_color button_label_active;
  103. struct dialog_color button_label_inactive;
  104. struct dialog_color inputbox;
  105. struct dialog_color inputbox_border;
  106. struct dialog_color searchbox;
  107. struct dialog_color searchbox_title;
  108. struct dialog_color searchbox_border;
  109. struct dialog_color position_indicator;
  110. struct dialog_color menubox;
  111. struct dialog_color menubox_border;
  112. struct dialog_color item;
  113. struct dialog_color item_selected;
  114. struct dialog_color tag;
  115. struct dialog_color tag_selected;
  116. struct dialog_color tag_key;
  117. struct dialog_color tag_key_selected;
  118. struct dialog_color check;
  119. struct dialog_color check_selected;
  120. struct dialog_color uarrow;
  121. struct dialog_color darrow;
  122. };
  123. /*
  124. * Global variables
  125. */
  126. extern struct dialog_info dlg;
  127. extern char dialog_input_result[];
  128. extern int saved_x, saved_y; /* Needed in signal handler in mconf.c */
  129. /*
  130. * Function prototypes
  131. */
  132. /* item list as used by checklist and menubox */
  133. void item_reset(void);
  134. void item_make(const char *fmt, ...);
  135. void item_add_str(const char *fmt, ...);
  136. void item_set_tag(char tag);
  137. void item_set_data(void *p);
  138. void item_set_selected(int val);
  139. int item_activate_selected(void);
  140. void *item_data(void);
  141. char item_tag(void);
  142. /* item list manipulation for lxdialog use */
  143. #define MAXITEMSTR 200
  144. struct dialog_item {
  145. char str[MAXITEMSTR]; /* prompt displayed */
  146. char tag;
  147. void *data; /* pointer to menu item - used by menubox+checklist */
  148. int selected; /* Set to 1 by dialog_*() function if selected. */
  149. };
  150. /* list of lialog_items */
  151. struct dialog_list {
  152. struct dialog_item node;
  153. struct dialog_list *next;
  154. };
  155. extern struct dialog_list *item_cur;
  156. extern struct dialog_list item_nil;
  157. extern struct dialog_list *item_head;
  158. int item_count(void);
  159. void item_set(int n);
  160. int item_n(void);
  161. const char *item_str(void);
  162. int item_is_selected(void);
  163. int item_is_tag(char tag);
  164. #define item_foreach() \
  165. for (item_cur = item_head ? item_head: item_cur; \
  166. item_cur && (item_cur != &item_nil); item_cur = item_cur->next)
  167. /* generic key handlers */
  168. int on_key_esc(WINDOW *win);
  169. int on_key_resize(void);
  170. /* minimum (re)size values */
  171. #define CHECKLIST_HEIGTH_MIN 6 /* For dialog_checklist() */
  172. #define CHECKLIST_WIDTH_MIN 6
  173. #define INPUTBOX_HEIGTH_MIN 2 /* For dialog_inputbox() */
  174. #define INPUTBOX_WIDTH_MIN 2
  175. #define MENUBOX_HEIGTH_MIN 15 /* For dialog_menu() */
  176. #define MENUBOX_WIDTH_MIN 65
  177. #define TEXTBOX_HEIGTH_MIN 8 /* For dialog_textbox() */
  178. #define TEXTBOX_WIDTH_MIN 8
  179. #define YESNO_HEIGTH_MIN 4 /* For dialog_yesno() */
  180. #define YESNO_WIDTH_MIN 4
  181. #define WINDOW_HEIGTH_MIN 19 /* For init_dialog() */
  182. #define WINDOW_WIDTH_MIN 80
  183. int init_dialog(const char *backtitle);
  184. void set_dialog_backtitle(const char *backtitle);
  185. void set_dialog_subtitles(struct subtitle_list *subtitles);
  186. void end_dialog(int x, int y);
  187. void attr_clear(WINDOW * win, int height, int width, chtype attr);
  188. void dialog_clear(void);
  189. void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x);
  190. void print_button(WINDOW * win, const char *label, int y, int x, int selected);
  191. void print_title(WINDOW *dialog, const char *title, int width);
  192. void draw_box(WINDOW * win, int y, int x, int height, int width, chtype box,
  193. chtype border);
  194. void draw_shadow(WINDOW * win, int y, int x, int height, int width);
  195. int first_alpha(const char *string, const char *exempt);
  196. int dialog_yesno(const char *title, const char *prompt, int height, int width);
  197. int dialog_msgbox(const char *title, const char *prompt, int height,
  198. int width, int pause);
  199. typedef void (*update_text_fn)(char *buf, size_t start, size_t end, void
  200. *_data);
  201. int dialog_textbox(const char *title, char *tbuf, int initial_height,
  202. int initial_width, int *keys, int *_vscroll, int *_hscroll,
  203. update_text_fn update_text, void *data);
  204. int dialog_menu(const char *title, const char *prompt,
  205. const void *selected, int *s_scroll);
  206. int dialog_checklist(const char *title, const char *prompt, int height,
  207. int width, int list_height);
  208. int dialog_inputbox(const char *title, const char *prompt, int height,
  209. int width, const char *init);
  210. /*
  211. * This is the base for fictitious keys, which activate
  212. * the buttons.
  213. *
  214. * Mouse-generated keys are the following:
  215. * -- the first 32 are used as numbers, in addition to '0'-'9'
  216. * -- the lowercase are used to signal mouse-enter events (M_EVENT + 'o')
  217. * -- uppercase chars are used to invoke the button (M_EVENT + 'O')
  218. */
  219. #define M_EVENT (KEY_MAX+1)