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