2 * dialog.h -- common declarations for all dialog modules
4 * AUTHOR: Savio Lam (lam836@cs.cuhk.hk)
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.
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.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, see <http://www.gnu.org/licenses/>.
20 #include <sys/types.h>
31 # define gettext(Msgid) ((const char *) (Msgid))
40 * Colors in ncurses 1.9.9e do not work properly since foreground and
41 * background colors are OR'd rather than separately masked. This version
42 * of dialog was hacked to work with ncurses 1.9.9e, making it incompatible
43 * with standard curses. The simplest fix (to make this work with standard
44 * curses) uses the wbkgdset() function, not used in the original hack.
45 * Turn it off if we're building with 1.9.9e, since it just confuses things.
47 #if defined(NCURSES_VERSION) && defined(_NEED_WRAP) && !defined(GCC_PRINTFLIKE)
50 #define wbkgdset(w,p) /*nothing */
55 #define TR(params) _tracef params
60 #define BUF_SIZE (10*1024)
61 #define MIN(x,y) (x < y ? x : y)
62 #define MAX(x,y) (x > y ? x : y)
65 #define ACS_ULCORNER '+'
68 #define ACS_LLCORNER '+'
71 #define ACS_URCORNER '+'
74 #define ACS_LRCORNER '+'
89 #define ACS_UARROW '^'
92 #define ACS_DARROW 'v'
95 /* error return codes */
96 #define ERRDISPLAYTOOSMALL (KEY_MAX + 1)
101 struct dialog_color {
102 chtype atr; /* Color attribute */
103 int fg; /* foreground */
104 int bg; /* background */
105 int hl; /* highlight this item */
109 const char *backtitle;
110 struct dialog_color screen;
111 struct dialog_color shadow;
112 struct dialog_color dialog;
113 struct dialog_color title;
114 struct dialog_color border;
115 struct dialog_color button_active;
116 struct dialog_color button_inactive;
117 struct dialog_color button_key_active;
118 struct dialog_color button_key_inactive;
119 struct dialog_color button_label_active;
120 struct dialog_color button_label_inactive;
121 struct dialog_color inputbox;
122 struct dialog_color inputbox_border;
123 struct dialog_color searchbox;
124 struct dialog_color searchbox_title;
125 struct dialog_color searchbox_border;
126 struct dialog_color position_indicator;
127 struct dialog_color menubox;
128 struct dialog_color menubox_border;
129 struct dialog_color item;
130 struct dialog_color item_selected;
131 struct dialog_color tag;
132 struct dialog_color tag_selected;
133 struct dialog_color tag_key;
134 struct dialog_color tag_key_selected;
135 struct dialog_color check;
136 struct dialog_color check_selected;
137 struct dialog_color uarrow;
138 struct dialog_color darrow;
144 extern struct dialog_info dlg;
145 extern char dialog_input_result[];
148 * Function prototypes
151 /* item list as used by checklist and menubox */
152 void item_reset(void);
153 void item_make(const char *fmt, ...);
154 void item_add_str(const char *fmt, ...);
155 void item_set_tag(char tag);
156 void item_set_data(void *p);
157 void item_set_selected(int val);
158 int item_activate_selected(void);
159 void *item_data(void);
162 /* item list manipulation for lxdialog use */
163 #define MAXITEMSTR 200
165 char str[MAXITEMSTR]; /* promtp displayed */
167 void *data; /* pointer to menu item - used by menubox+checklist */
168 int selected; /* Set to 1 by dialog_*() function if selected. */
171 /* list of lialog_items */
173 struct dialog_item node;
174 struct dialog_list *next;
177 extern struct dialog_list *item_cur;
178 extern struct dialog_list item_nil;
179 extern struct dialog_list *item_head;
181 int item_count(void);
182 void item_set(int n);
184 const char *item_str(void);
185 int item_is_selected(void);
186 int item_is_tag(char tag);
187 #define item_foreach() \
188 for (item_cur = item_head ? item_head: item_cur; \
189 item_cur && (item_cur != &item_nil); item_cur = item_cur->next)
191 /* generic key handlers */
192 int on_key_esc(WINDOW *win);
193 int on_key_resize(void);
195 int init_dialog(const char *backtitle);
196 void set_dialog_backtitle(const char *backtitle);
197 void end_dialog(int x, int y);
198 void attr_clear(WINDOW * win, int height, int width, chtype attr);
199 void dialog_clear(void);
200 void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x);
201 void print_button(WINDOW * win, const char *label, int y, int x, int selected);
202 void print_title(WINDOW *dialog, const char *title, int width);
203 void draw_box(WINDOW * win, int y, int x, int height, int width, chtype box,
205 void draw_shadow(WINDOW * win, int y, int x, int height, int width);
207 int first_alpha(const char *string, const char *exempt);
208 int dialog_yesno(const char *title, const char *prompt, int height, int width);
209 int dialog_msgbox(const char *title, const char *prompt, int height,
210 int width, int pause);
211 int dialog_textbox(const char *title, const char *file, int height, int width);
212 int dialog_menu(const char *title, const char *prompt,
213 const void *selected, int *s_scroll);
214 int dialog_checklist(const char *title, const char *prompt, int height,
215 int width, int list_height);
216 extern char dialog_input_result[];
217 int dialog_inputbox(const char *title, const char *prompt, int height,
218 int width, const char *init);
221 * This is the base for fictitious keys, which activate
224 * Mouse-generated keys are the following:
225 * -- the first 32 are used as numbers, in addition to '0'-'9'
226 * -- the lowercase are used to signal mouse-enter events (M_EVENT + 'o')
227 * -- uppercase chars are used to invoke the button (M_EVENT + 'O')
229 #define M_EVENT (KEY_MAX+1)