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