1 /* SPDX-License-Identifier: GPL-2.0+ */
3 * dialog.h -- common declarations for all dialog modules
5 * AUTHOR: Savio Lam (lam836@cs.cuhk.hk)
21 #define TR(params) _tracef params
26 #define BUF_SIZE (10*1024)
27 #define MIN(x,y) (x < y ? x : y)
28 #define MAX(x,y) (x > y ? x : y)
31 #define ACS_ULCORNER '+'
34 #define ACS_LLCORNER '+'
37 #define ACS_URCORNER '+'
40 #define ACS_LRCORNER '+'
55 #define ACS_UARROW '^'
58 #define ACS_DARROW 'v'
61 /* error return codes */
62 #define ERRDISPLAYTOOSMALL (KEY_MAX + 1)
68 chtype atr; /* Color attribute */
69 int fg; /* foreground */
70 int bg; /* background */
71 int hl; /* highlight this item */
74 struct subtitle_list {
75 struct subtitle_list *next;
80 const char *backtitle;
81 struct subtitle_list *subtitles;
82 struct dialog_color screen;
83 struct dialog_color shadow;
84 struct dialog_color dialog;
85 struct dialog_color title;
86 struct dialog_color border;
87 struct dialog_color button_active;
88 struct dialog_color button_inactive;
89 struct dialog_color button_key_active;
90 struct dialog_color button_key_inactive;
91 struct dialog_color button_label_active;
92 struct dialog_color button_label_inactive;
93 struct dialog_color inputbox;
94 struct dialog_color position_indicator;
95 struct dialog_color menubox;
96 struct dialog_color menubox_border;
97 struct dialog_color item;
98 struct dialog_color item_selected;
99 struct dialog_color tag;
100 struct dialog_color tag_selected;
101 struct dialog_color tag_key;
102 struct dialog_color tag_key_selected;
103 struct dialog_color check;
104 struct dialog_color check_selected;
105 struct dialog_color uarrow;
106 struct dialog_color darrow;
112 extern struct dialog_info dlg;
113 extern char dialog_input_result[];
114 extern int saved_x, saved_y; /* Needed in signal handler in mconf.c */
117 * Function prototypes
120 /* item list as used by checklist and menubox */
121 void item_reset(void);
122 void item_make(const char *fmt, ...);
123 void item_add_str(const char *fmt, ...);
124 void item_set_tag(char tag);
125 void item_set_data(void *p);
126 void item_set_selected(int val);
127 int item_activate_selected(void);
128 void *item_data(void);
131 /* item list manipulation for lxdialog use */
132 #define MAXITEMSTR 200
134 char str[MAXITEMSTR]; /* prompt displayed */
136 void *data; /* pointer to menu item - used by menubox+checklist */
137 int selected; /* Set to 1 by dialog_*() function if selected. */
140 /* list of lialog_items */
142 struct dialog_item node;
143 struct dialog_list *next;
146 extern struct dialog_list *item_cur;
147 extern struct dialog_list item_nil;
148 extern struct dialog_list *item_head;
150 int item_count(void);
151 void item_set(int n);
153 const char *item_str(void);
154 int item_is_selected(void);
155 int item_is_tag(char tag);
156 #define item_foreach() \
157 for (item_cur = item_head ? item_head: item_cur; \
158 item_cur && (item_cur != &item_nil); item_cur = item_cur->next)
160 /* generic key handlers */
161 int on_key_esc(WINDOW *win);
162 int on_key_resize(void);
164 /* minimum (re)size values */
165 #define CHECKLIST_HEIGHT_MIN 6 /* For dialog_checklist() */
166 #define CHECKLIST_WIDTH_MIN 6
167 #define INPUTBOX_HEIGHT_MIN 2 /* For dialog_inputbox() */
168 #define INPUTBOX_WIDTH_MIN 2
169 #define MENUBOX_HEIGHT_MIN 15 /* For dialog_menu() */
170 #define MENUBOX_WIDTH_MIN 65
171 #define TEXTBOX_HEIGHT_MIN 8 /* For dialog_textbox() */
172 #define TEXTBOX_WIDTH_MIN 8
173 #define YESNO_HEIGHT_MIN 4 /* For dialog_yesno() */
174 #define YESNO_WIDTH_MIN 4
175 #define WINDOW_HEIGHT_MIN 19 /* For init_dialog() */
176 #define WINDOW_WIDTH_MIN 80
178 int init_dialog(const char *backtitle);
179 void set_dialog_backtitle(const char *backtitle);
180 void set_dialog_subtitles(struct subtitle_list *subtitles);
181 void end_dialog(int x, int y);
182 void attr_clear(WINDOW * win, int height, int width, chtype attr);
183 void dialog_clear(void);
184 void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x);
185 void print_button(WINDOW * win, const char *label, int y, int x, int selected);
186 void print_title(WINDOW *dialog, const char *title, int width);
187 void draw_box(WINDOW * win, int y, int x, int height, int width, chtype box,
189 void draw_shadow(WINDOW * win, int y, int x, int height, int width);
191 int first_alpha(const char *string, const char *exempt);
192 int dialog_yesno(const char *title, const char *prompt, int height, int width);
193 int dialog_msgbox(const char *title, const char *prompt, int height,
194 int width, int pause);
195 int dialog_textbox(const char *title, const char *tbuf, int initial_height,
196 int initial_width, int *_vscroll, int *_hscroll,
197 int (*extra_key_cb)(int, size_t, size_t, void *), void *data);
198 int dialog_menu(const char *title, const char *prompt,
199 const void *selected, int *s_scroll);
200 int dialog_checklist(const char *title, const char *prompt, int height,
201 int width, int list_height);
202 int dialog_inputbox(const char *title, const char *prompt, int height,
203 int width, const char *init);