|
0
|
1 /* Generic toolbar implementation.
|
|
|
2 Copyright (C) 1995 Board of Trustees, University of Illinois.
|
|
|
3 Copyright (C) 1995 Sun Microsystems, Inc.
|
|
|
4 Copyright (C) 1995, 1996 Ben Wing.
|
|
|
5 Copyright (C) 1996 Chuck Thompson.
|
|
|
6
|
|
|
7 This file is part of XEmacs.
|
|
|
8
|
|
|
9 XEmacs is free software; you can redistribute it and/or modify it
|
|
|
10 under the terms of the GNU General Public License as published by the
|
|
|
11 Free Software Foundation; either version 2, or (at your option) any
|
|
|
12 later version.
|
|
|
13
|
|
|
14 XEmacs is distributed in the hope that it will be useful, but WITHOUT
|
|
|
15 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
16 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
17 for more details.
|
|
|
18
|
|
|
19 You should have received a copy of the GNU General Public License
|
|
|
20 along with XEmacs; see the file COPYING. If not, write to
|
|
|
21 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
22 Boston, MA 02111-1307, USA. */
|
|
|
23
|
|
|
24 /* Synched up with: Not in FSF. */
|
|
|
25
|
|
|
26 /* Original implementation by Chuck Thompson for 19.12.
|
|
|
27 Default-toolbar-position and specifier-related stuff by Ben Wing. */
|
|
|
28
|
|
|
29 #include <config.h>
|
|
|
30 #include "lisp.h"
|
|
|
31
|
|
|
32 #include "buffer.h"
|
|
|
33 #include "frame.h"
|
|
|
34 #include "device.h"
|
|
|
35 #include "glyphs.h"
|
|
|
36 #include "redisplay.h"
|
|
|
37 #include "toolbar.h"
|
|
|
38 #include "window.h"
|
|
|
39
|
|
|
40 Lisp_Object Vtoolbar[4];
|
|
|
41 Lisp_Object Vtoolbar_size[4];
|
|
|
42 Lisp_Object Vtoolbar_visible_p[4];
|
|
|
43
|
|
|
44 Lisp_Object Vdefault_toolbar, Vdefault_toolbar_visible_p;
|
|
|
45 Lisp_Object Vdefault_toolbar_width, Vdefault_toolbar_height;
|
|
|
46
|
|
|
47 Lisp_Object Vdefault_toolbar_position;
|
|
|
48 Lisp_Object Vtoolbar_buttons_captioned_p;
|
|
|
49
|
|
|
50 Lisp_Object Qtoolbar_buttonp;
|
|
|
51 Lisp_Object Q2D, Q3D, Q2d, Q3d;
|
|
|
52 Lisp_Object Q_size;
|
|
|
53 extern Lisp_Object Q_style; /* defined in menubar.c */
|
|
|
54
|
|
|
55 Lisp_Object Qinit_toolbar_from_resources;
|
|
|
56
|
|
|
57
|
|
|
58 static Lisp_Object
|
|
|
59 mark_toolbar_data (Lisp_Object obj, void (*markobj) (Lisp_Object))
|
|
|
60 {
|
|
|
61 struct toolbar_data *data = (struct toolbar_data *) XPNTR (obj);
|
|
|
62 ((markobj) (data->last_toolbar_buffer));
|
|
|
63 return (data->toolbar_buttons);
|
|
|
64 }
|
|
|
65
|
|
|
66 DEFINE_LRECORD_IMPLEMENTATION ("toolbar-data", toolbar_data,
|
|
|
67 mark_toolbar_data, internal_object_printer,
|
|
|
68 0, 0, 0, struct toolbar_data);
|
|
|
69
|
|
|
70 static Lisp_Object
|
|
|
71 mark_toolbar_button (Lisp_Object obj, void (*markobj) (Lisp_Object))
|
|
|
72 {
|
|
|
73 struct toolbar_button *data = (struct toolbar_button *) XPNTR (obj);
|
|
|
74 ((markobj) (data->next));
|
|
|
75 ((markobj) (data->frame));
|
|
|
76 ((markobj) (data->up_glyph));
|
|
|
77 ((markobj) (data->down_glyph));
|
|
|
78 ((markobj) (data->disabled_glyph));
|
|
|
79 ((markobj) (data->cap_up_glyph));
|
|
|
80 ((markobj) (data->cap_down_glyph));
|
|
|
81 ((markobj) (data->cap_disabled_glyph));
|
|
|
82 ((markobj) (data->callback));
|
|
|
83 ((markobj) (data->enabled_p));
|
|
|
84 return (data->help_string);
|
|
|
85 }
|
|
|
86
|
|
|
87 static void
|
|
|
88 print_toolbar_button (Lisp_Object obj, Lisp_Object printcharfun,
|
|
|
89 int escapeflag)
|
|
|
90 {
|
|
|
91 struct toolbar_button *tb = XTOOLBAR_BUTTON (obj);
|
|
|
92 char buf[100];
|
|
|
93
|
|
|
94 if (print_readably)
|
|
|
95 error ("printing unreadable object #<toolbar-button 0x%x>",
|
|
|
96 tb->header.uid);
|
|
|
97
|
|
|
98 sprintf (buf, "#<toolbar-button 0x%x>", tb->header.uid);
|
|
|
99 write_c_string (buf, printcharfun);
|
|
|
100 }
|
|
|
101
|
|
|
102 DEFINE_LRECORD_IMPLEMENTATION ("toolbar-button", toolbar_button,
|
|
|
103 mark_toolbar_button, print_toolbar_button,
|
|
|
104 0, 0, 0,
|
|
|
105 struct toolbar_button);
|
|
|
106
|
|
|
107 DEFUN ("toolbar-button-p", Ftoolbar_button_p, Stoolbar_button_p, 1, 1, 0 /*
|
|
|
108 Return non-nil if OBJECT is a toolbar button.
|
|
|
109 */ )
|
|
|
110 (object)
|
|
|
111 Lisp_Object object;
|
|
|
112 {
|
|
|
113 return (TOOLBAR_BUTTONP (object) ? Qt : Qnil);
|
|
|
114 }
|
|
|
115
|
|
|
116 /* Only query functions are provided for toolbar buttons. They are
|
|
|
117 generated and updated from a toolbar description list. Any
|
|
|
118 directly made changes would be wiped out the first time the toolbar
|
|
|
119 was marked as dirty and was regenerated. The exception to this is
|
|
|
120 set-toolbar-button-down-flag. Having this allows us to control the
|
|
|
121 toolbar from elisp. Since we only trigger the button callbacks on
|
|
|
122 up-mouse events and we reset the flag first, there shouldn't be any
|
|
|
123 way for this to get us in trouble (like if someone decides to
|
|
|
124 change the toolbar from a toolbar callback). */
|
|
|
125
|
|
|
126 DEFUN ("toolbar-button-callback", Ftoolbar_button_callback,
|
|
|
127 Stoolbar_button_callback, 1, 1, 0 /*
|
|
|
128 Return the callback function associated with the toolbar BUTTON.
|
|
|
129 */ )
|
|
|
130 (button)
|
|
|
131 Lisp_Object button;
|
|
|
132 {
|
|
|
133 CHECK_TOOLBAR_BUTTON (button);
|
|
|
134
|
|
|
135 return (XTOOLBAR_BUTTON (button)->callback);
|
|
|
136 }
|
|
|
137
|
|
|
138 DEFUN ("toolbar-button-help-string", Ftoolbar_button_help_string,
|
|
|
139 Stoolbar_button_help_string, 1, 1, 0 /*
|
|
|
140 Return the help string function associated with the toolbar BUTTON.
|
|
|
141 */ )
|
|
|
142 (button)
|
|
|
143 Lisp_Object button;
|
|
|
144 {
|
|
|
145 CHECK_TOOLBAR_BUTTON (button);
|
|
|
146
|
|
|
147 return (XTOOLBAR_BUTTON (button)->help_string);
|
|
|
148 }
|
|
|
149
|
|
|
150 DEFUN ("toolbar-button-enabled-p", Ftoolbar_button_enabled_p,
|
|
|
151 Stoolbar_button_enabled_p, 1, 1, 0 /*
|
|
|
152 Return t if BUTTON is active.
|
|
|
153 */ )
|
|
|
154 (button)
|
|
|
155 Lisp_Object button;
|
|
|
156 {
|
|
|
157 CHECK_TOOLBAR_BUTTON (button);
|
|
|
158
|
|
|
159 return (XTOOLBAR_BUTTON (button)->enabled ? Qt : Qnil);
|
|
|
160 }
|
|
|
161
|
|
|
162 DEFUN ("set-toolbar-button-down-flag", Fset_toolbar_button_down_flag,
|
|
|
163 Sset_toolbar_button_down_flag, 2, 2, 0 /*
|
|
|
164 Don't touch.
|
|
|
165 */ )
|
|
|
166 (button, flag)
|
|
|
167 Lisp_Object button, flag;
|
|
|
168 {
|
|
|
169 struct toolbar_button *tb;
|
|
|
170 char old_flag;
|
|
|
171
|
|
|
172 CHECK_TOOLBAR_BUTTON (button);
|
|
|
173 tb = XTOOLBAR_BUTTON (button);
|
|
|
174 old_flag = tb->down;
|
|
|
175
|
|
|
176 /* If the button is ignored, don't do anything. */
|
|
|
177 if (!tb->enabled)
|
|
|
178 return Qnil;
|
|
|
179
|
|
|
180 /* If flag is nil, unset the down flag, otherwise set it to true.
|
|
|
181 This also triggers an immediate redraw of the button if the flag
|
|
|
182 does change. */
|
|
|
183
|
|
|
184 if (NILP (flag))
|
|
|
185 tb->down = 0;
|
|
|
186 else
|
|
|
187 tb->down = 1;
|
|
|
188
|
|
|
189 if (tb->down != old_flag)
|
|
|
190 {
|
|
|
191 struct frame *f = XFRAME (tb->frame);
|
|
|
192 struct device *d;
|
|
|
193
|
|
|
194 if (DEVICEP (f->device))
|
|
|
195 {
|
|
|
196 d = XDEVICE (f->device);
|
|
|
197
|
|
|
198 if (DEVICE_LIVE_P (XDEVICE (f->device)))
|
|
|
199 {
|
|
|
200 tb->dirty = 1;
|
|
|
201 MAYBE_DEVMETH (d, output_toolbar_button, (f, button));
|
|
|
202 }
|
|
|
203 }
|
|
|
204 }
|
|
|
205
|
|
|
206 return Qnil;
|
|
|
207 }
|
|
|
208
|
|
|
209 Lisp_Object
|
|
|
210 get_toolbar_button_glyph (struct window *w, struct toolbar_button *tb)
|
|
|
211 {
|
|
|
212 Lisp_Object glyph = Qnil;
|
|
|
213
|
|
|
214 /* The selected glyph logic:
|
|
|
215
|
|
|
216 UP: up
|
|
|
217 DOWN: down -> up
|
|
|
218 DISABLED: disabled -> up
|
|
|
219 CAP-UP: cap-up -> up
|
|
|
220 CAP-DOWN: cap-down -> cap-up -> down -> up
|
|
|
221 CAP-DISABLED: cap-disabled -> cap-up -> disabled -> up
|
|
|
222 */
|
|
|
223
|
|
|
224 if (!NILP (w->toolbar_buttons_captioned_p))
|
|
|
225 {
|
|
|
226 if (tb->enabled && tb->down)
|
|
|
227 glyph = tb->cap_down_glyph;
|
|
|
228 else if (!tb->enabled)
|
|
|
229 glyph = tb->cap_disabled_glyph;
|
|
|
230
|
|
|
231 if (NILP (glyph))
|
|
|
232 glyph = tb->cap_up_glyph;
|
|
|
233 }
|
|
|
234
|
|
|
235 if (NILP (glyph))
|
|
|
236 {
|
|
|
237 if (tb->enabled && tb->down)
|
|
|
238 glyph = tb->down_glyph;
|
|
|
239 else if (!tb->enabled)
|
|
|
240 glyph = tb->disabled_glyph;
|
|
|
241 }
|
|
|
242
|
|
|
243 /* The non-captioned up button is the ultimate fallback. It is
|
|
|
244 the only one we guarantee exists. */
|
|
|
245 if (NILP (glyph))
|
|
|
246 glyph = tb->up_glyph;
|
|
|
247
|
|
|
248 return glyph;
|
|
|
249 }
|
|
|
250
|
|
|
251
|
|
|
252 static enum toolbar_pos
|
|
|
253 decode_toolbar_position (Lisp_Object position)
|
|
|
254 {
|
|
2
|
255 if (EQ (position, Qtop)) return TOP_TOOLBAR;
|
|
|
256 if (EQ (position, Qbottom)) return BOTTOM_TOOLBAR;
|
|
|
257 if (EQ (position, Qleft)) return LEFT_TOOLBAR;
|
|
|
258 if (EQ (position, Qright)) return RIGHT_TOOLBAR;
|
|
0
|
259 signal_simple_error ("Invalid toolbar position", position);
|
|
2
|
260
|
|
|
261 return TOP_TOOLBAR; /* not reached */
|
|
0
|
262 }
|
|
|
263
|
|
|
264 DEFUN ("set-default-toolbar-position", Fset_default_toolbar_position,
|
|
|
265 Sset_default_toolbar_position, 1, 1, 0 /*
|
|
|
266 Set the position that the `default-toolbar' will be displayed at.
|
|
|
267 Valid positions are 'top, 'bottom, 'left and 'right.
|
|
|
268 See `default-toolbar-position'.
|
|
|
269 */ )
|
|
|
270 (position)
|
|
|
271 Lisp_Object position;
|
|
|
272 {
|
|
|
273 enum toolbar_pos cur = decode_toolbar_position (Vdefault_toolbar_position);
|
|
|
274 enum toolbar_pos new = decode_toolbar_position (position);
|
|
|
275
|
|
|
276 if (cur != new)
|
|
|
277 {
|
|
|
278 /* The following calls will automatically cause the dirty
|
|
|
279 flags to be set; we delay frame size changes to avoid
|
|
|
280 lots of frame flickering. */
|
|
|
281 hold_frame_size_changes ();
|
|
|
282 set_specifier_fallback (Vtoolbar[cur], list1 (Fcons (Qnil, Qnil)));
|
|
|
283 set_specifier_fallback (Vtoolbar[new], Vdefault_toolbar);
|
|
|
284 set_specifier_fallback (Vtoolbar_size[cur], list1 (Fcons (Qnil, Qzero)));
|
|
|
285 set_specifier_fallback (Vtoolbar_size[new],
|
|
|
286 new == TOP_TOOLBAR || new == BOTTOM_TOOLBAR
|
|
|
287 ? Vdefault_toolbar_height
|
|
|
288 : Vdefault_toolbar_width);
|
|
|
289 set_specifier_fallback (Vtoolbar_visible_p[cur],
|
|
|
290 list1 (Fcons (Qnil, Qt)));
|
|
|
291 set_specifier_fallback (Vtoolbar_visible_p[new],
|
|
|
292 Vdefault_toolbar_visible_p);
|
|
|
293 Vdefault_toolbar_position = position;
|
|
|
294 unhold_frame_size_changes ();
|
|
|
295 }
|
|
|
296
|
|
|
297 return position;
|
|
|
298 }
|
|
|
299
|
|
|
300 DEFUN ("default-toolbar-position", Fdefault_toolbar_position,
|
|
|
301 Sdefault_toolbar_position, 0, 0, 0 /*
|
|
|
302 Return the position that the `default-toolbar' will be displayed at.
|
|
|
303 The `default-toolbar' will only be displayed here if the corresponding
|
|
|
304 position-specific toolbar specifier does not provide a value.
|
|
|
305 */ )
|
|
|
306 ()
|
|
|
307 {
|
|
|
308 return Vdefault_toolbar_position;
|
|
|
309 }
|
|
|
310
|
|
|
311
|
|
|
312 static Lisp_Object
|
|
|
313 update_toolbar_button (struct frame *f, struct toolbar_button *tb,
|
|
|
314 Lisp_Object desc, int pushright)
|
|
|
315 {
|
|
|
316 Lisp_Object *elt, glyphs, retval, buffer;
|
|
|
317 struct gcpro gcpro1, gcpro2;
|
|
|
318
|
|
|
319 elt = vector_data (XVECTOR (desc));
|
|
|
320 buffer = XWINDOW (FRAME_LAST_NONMINIBUF_WINDOW (f))->buffer;
|
|
|
321
|
|
|
322 if (!tb)
|
|
|
323 {
|
|
|
324 tb = alloc_lcrecord (sizeof (struct toolbar_button),
|
|
|
325 lrecord_toolbar_button);
|
|
|
326 tb->next = Qnil;
|
|
|
327 XSETFRAME (tb->frame, f);
|
|
|
328 tb->up_glyph = Qnil;
|
|
|
329 tb->down_glyph = Qnil;
|
|
|
330 tb->disabled_glyph = Qnil;
|
|
|
331 tb->cap_up_glyph = Qnil;
|
|
|
332 tb->cap_down_glyph = Qnil;
|
|
|
333 tb->cap_disabled_glyph = Qnil;
|
|
|
334 tb->callback = Qnil;
|
|
|
335 tb->enabled_p = Qnil;
|
|
|
336 tb->help_string = Qnil;
|
|
|
337
|
|
|
338 tb->enabled = 0;
|
|
|
339 tb->down = 0;
|
|
|
340 tb->pushright = pushright;
|
|
|
341 tb->blank = 0;
|
|
|
342 tb->x = tb->y = tb->width = tb->height = -1;
|
|
|
343 tb->dirty = 1;
|
|
|
344 }
|
|
|
345 XSETTOOLBAR_BUTTON (retval, tb);
|
|
|
346
|
|
|
347 /* Let's make sure nothing gets mucked up by the potential call to
|
|
|
348 eval farther down. */
|
|
|
349 GCPRO2 (retval, desc);
|
|
|
350
|
|
|
351 glyphs = (CONSP (elt[0]) ? elt[0] : symbol_value_in_buffer (elt[0], buffer));
|
|
|
352
|
|
|
353 /* If this is true we have a blank, otherwise it is an actual
|
|
|
354 button. */
|
|
|
355 if (KEYWORDP (glyphs))
|
|
|
356 {
|
|
|
357 int pos;
|
|
|
358 int style_seen = 0;
|
|
|
359 int size_seen = 0;
|
|
|
360
|
|
|
361 if (!tb->blank)
|
|
|
362 {
|
|
|
363 tb->blank = 1;
|
|
|
364 tb->dirty = 1;
|
|
|
365 }
|
|
|
366
|
|
|
367 for (pos = 0; pos < vector_length (XVECTOR (desc)); pos += 2)
|
|
|
368 {
|
|
|
369 Lisp_Object key = elt[pos];
|
|
|
370 Lisp_Object val = elt[pos + 1];
|
|
|
371
|
|
|
372 if (EQ (key, Q_style))
|
|
|
373 {
|
|
|
374 style_seen = 1;
|
|
|
375
|
|
|
376 if (EQ (val, Q2D) || EQ (val, Q2d))
|
|
|
377 {
|
|
|
378 if (!EQ (Qnil, tb->up_glyph) || !EQ (Qt, tb->disabled_glyph))
|
|
|
379 {
|
|
|
380 tb->up_glyph = Qnil;
|
|
|
381 tb->disabled_glyph = Qt;
|
|
|
382 tb->dirty = 1;
|
|
|
383 }
|
|
|
384 }
|
|
|
385 else if (EQ (val, Q3D) || (EQ (val, Q3d)))
|
|
|
386 {
|
|
|
387 if (!EQ (Qt, tb->up_glyph) || !EQ (Qnil, tb->disabled_glyph))
|
|
|
388 {
|
|
|
389 tb->up_glyph = Qt;
|
|
|
390 tb->disabled_glyph = Qnil;
|
|
|
391 tb->dirty = 1;
|
|
|
392 }
|
|
|
393 }
|
|
|
394 }
|
|
|
395 else if (EQ (key, Q_size))
|
|
|
396 {
|
|
|
397 size_seen = 1;
|
|
|
398
|
|
|
399 if (!EQ (val, tb->down_glyph))
|
|
|
400 {
|
|
|
401 tb->down_glyph = val;
|
|
|
402 tb->dirty = 1;
|
|
|
403 }
|
|
|
404 }
|
|
|
405 }
|
|
|
406
|
|
|
407 if (!style_seen)
|
|
|
408 {
|
|
|
409 /* The default style is 3D. */
|
|
|
410 if (!EQ (Qt, tb->up_glyph) || !EQ (Qnil, tb->disabled_glyph))
|
|
|
411 {
|
|
|
412 tb->up_glyph = Qt;
|
|
|
413 tb->disabled_glyph = Qnil;
|
|
|
414 tb->dirty = 1;
|
|
|
415 }
|
|
|
416 }
|
|
|
417
|
|
|
418 if (!size_seen)
|
|
|
419 {
|
|
|
420 /* The default width is set to nil. The device specific
|
|
|
421 code will fill it in at its discretion. */
|
|
|
422 if (!NILP (tb->down_glyph))
|
|
|
423 {
|
|
|
424 tb->down_glyph = Qnil;
|
|
|
425 tb->dirty = 1;
|
|
|
426 }
|
|
|
427 }
|
|
|
428
|
|
|
429 /* The rest of these fields are not used by blanks. We make
|
|
|
430 sure they are nulled out in case this button object formerly
|
|
|
431 represented a real button. */
|
|
|
432 if (!NILP (tb->callback)
|
|
|
433 || !NILP (tb->enabled_p)
|
|
|
434 || !NILP (tb->help_string))
|
|
|
435 {
|
|
|
436 tb->cap_up_glyph = Qnil;
|
|
|
437 tb->cap_down_glyph = Qnil;
|
|
|
438 tb->cap_disabled_glyph = Qnil;
|
|
|
439 tb->callback = Qnil;
|
|
|
440 tb->enabled_p = Qnil;
|
|
|
441 tb->help_string = Qnil;
|
|
|
442 tb->dirty = 1;
|
|
|
443 }
|
|
|
444 }
|
|
|
445 else
|
|
|
446 {
|
|
|
447 if (tb->blank)
|
|
|
448 {
|
|
|
449 tb->blank = 0;
|
|
|
450 tb->dirty = 1;
|
|
|
451 }
|
|
|
452
|
|
|
453 /* We know that we at least have an up_glyph. Well, no, we
|
|
|
454 don't. The user may have changed the button glyph on us. */
|
|
|
455 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
456 {
|
|
|
457 if (!EQ (XCAR (glyphs), tb->up_glyph))
|
|
|
458 {
|
|
|
459 tb->up_glyph = XCAR (glyphs);
|
|
|
460 tb->dirty = 1;
|
|
|
461 }
|
|
|
462 glyphs = XCDR (glyphs);
|
|
|
463 }
|
|
|
464 else
|
|
|
465 tb->up_glyph = Qnil;
|
|
|
466
|
|
|
467 /* We might have a down_glyph. */
|
|
|
468 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
469 {
|
|
|
470 if (!EQ (XCAR (glyphs), tb->down_glyph))
|
|
|
471 {
|
|
|
472 tb->down_glyph = XCAR (glyphs);
|
|
|
473 tb->dirty = 1;
|
|
|
474 }
|
|
|
475 glyphs = XCDR (glyphs);
|
|
|
476 }
|
|
|
477 else
|
|
|
478 tb->down_glyph = Qnil;
|
|
|
479
|
|
|
480 /* We might have a disabled_glyph. */
|
|
|
481 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
482 {
|
|
|
483 if (!EQ (XCAR (glyphs), tb->disabled_glyph))
|
|
|
484 {
|
|
|
485 tb->disabled_glyph = XCAR (glyphs);
|
|
|
486 tb->dirty = 1;
|
|
|
487 }
|
|
|
488 glyphs = XCDR (glyphs);
|
|
|
489 }
|
|
|
490 else
|
|
|
491 tb->disabled_glyph = Qnil;
|
|
|
492
|
|
|
493 /* We might have a cap_up_glyph. */
|
|
|
494 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
495 {
|
|
|
496 if (!EQ (XCAR (glyphs), tb->cap_up_glyph))
|
|
|
497 {
|
|
|
498 tb->cap_up_glyph = XCAR (glyphs);
|
|
|
499 tb->dirty = 1;
|
|
|
500 }
|
|
|
501 glyphs = XCDR (glyphs);
|
|
|
502 }
|
|
|
503 else
|
|
|
504 tb->cap_up_glyph = Qnil;
|
|
|
505
|
|
|
506 /* We might have a cap_down_glyph. */
|
|
|
507 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
508 {
|
|
|
509 if (!EQ (XCAR (glyphs), tb->cap_down_glyph))
|
|
|
510 {
|
|
|
511 tb->cap_down_glyph = XCAR (glyphs);
|
|
|
512 tb->dirty = 1;
|
|
|
513 }
|
|
|
514 glyphs = XCDR (glyphs);
|
|
|
515 }
|
|
|
516 else
|
|
|
517 tb->cap_down_glyph = Qnil;
|
|
|
518
|
|
|
519 /* We might have a cap_disabled_glyph. */
|
|
|
520 if (!NILP (glyphs) && CONSP (glyphs))
|
|
|
521 {
|
|
|
522 if (!EQ (XCAR (glyphs), tb->cap_disabled_glyph))
|
|
|
523 {
|
|
|
524 tb->cap_disabled_glyph = XCAR (glyphs);
|
|
|
525 tb->dirty = 1;
|
|
|
526 }
|
|
|
527 }
|
|
|
528 else
|
|
|
529 tb->cap_disabled_glyph = Qnil;
|
|
|
530
|
|
|
531 /* Update the callback. */
|
|
|
532 if (!EQ (tb->callback, elt[1]))
|
|
|
533 {
|
|
|
534 tb->callback = elt[1];
|
|
|
535 /* This does not have an impact on the display properties of the
|
|
|
536 button so we do not mark it as dirty if it has changed. */
|
|
|
537 }
|
|
|
538
|
|
|
539 /* Update the enabled field. */
|
|
|
540 if (!EQ (tb->enabled_p, elt[2]))
|
|
|
541 {
|
|
|
542 tb->enabled_p = elt[2];
|
|
|
543 tb->dirty = 1;
|
|
|
544 }
|
|
|
545
|
|
|
546 /* We always do the following because if the enabled status is
|
|
|
547 determined by a function its decision may change without us being
|
|
|
548 able to detect it. */
|
|
|
549 {
|
|
|
550 int old_enabled = tb->enabled;
|
|
|
551
|
|
|
552 if (NILP (tb->enabled_p))
|
|
|
553 tb->enabled = 0;
|
|
|
554 else if (EQ (tb->enabled_p, Qt))
|
|
|
555 tb->enabled = 1;
|
|
|
556 else
|
|
|
557 {
|
|
|
558 if (NILP (tb->enabled_p) || EQ (tb->enabled_p, Qt))
|
|
|
559 /* short-circuit the common case for speed */
|
|
|
560 tb->enabled = !NILP (tb->enabled_p);
|
|
|
561 else
|
|
|
562 {
|
|
|
563 Lisp_Object result =
|
|
|
564 eval_in_buffer_trapping_errors
|
|
|
565 ("Error in toolbar enabled-p form",
|
|
|
566 XBUFFER
|
|
|
567 (WINDOW_BUFFER
|
|
|
568 (XWINDOW (FRAME_LAST_NONMINIBUF_WINDOW (f)))),
|
|
|
569 tb->enabled_p);
|
|
|
570 if (UNBOUNDP (result))
|
|
|
571 /* #### if there was an error in the enabled-p
|
|
|
572 form, should we pretend like it's enabled
|
|
|
573 or disabled? */
|
|
|
574 tb->enabled = 0;
|
|
|
575 else
|
|
|
576 tb->enabled = !NILP (result);
|
|
|
577 }
|
|
|
578 }
|
|
|
579
|
|
|
580 if (old_enabled != tb->enabled)
|
|
|
581 tb->dirty = 1;
|
|
|
582 }
|
|
|
583
|
|
|
584 /* Update the help echo string. */
|
|
|
585 if (!EQ (tb->help_string, elt[3]))
|
|
|
586 {
|
|
|
587 tb->help_string = elt[3];
|
|
|
588 /* This does not have an impact on the display properties of the
|
|
|
589 button so we do not mark it as dirty if it has changed. */
|
|
|
590 }
|
|
|
591 }
|
|
|
592
|
|
|
593 /* If this flag changes, the position is changing for sure unless
|
|
|
594 some very unlikely geometry occurs. */
|
|
|
595 if (tb->pushright != pushright)
|
|
|
596 {
|
|
|
597 tb->pushright = pushright;
|
|
|
598 tb->dirty = 1;
|
|
|
599 }
|
|
|
600
|
|
|
601 /* The position and size fields are only manipulated in the
|
|
|
602 device-dependent code. */
|
|
|
603 UNGCPRO;
|
|
|
604 return retval;
|
|
|
605 }
|
|
|
606
|
|
|
607 static Lisp_Object
|
|
|
608 compute_frame_toolbar_buttons (struct frame *f, enum toolbar_pos pos,
|
|
|
609 Lisp_Object toolbar)
|
|
|
610 {
|
|
|
611 Lisp_Object buttons, prev_button, first_button;
|
|
|
612 Lisp_Object orig_toolbar = toolbar;
|
|
|
613 int pushright_seen = 0;
|
|
|
614 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
|
|
|
615
|
|
|
616 first_button = FRAME_TOOLBAR_DATA (f, pos)->toolbar_buttons;
|
|
|
617 buttons = prev_button = first_button;
|
|
|
618
|
|
|
619 /* Yes, we're being paranoid. */
|
|
|
620 GCPRO5 (toolbar, buttons, prev_button, first_button, orig_toolbar);
|
|
|
621
|
|
|
622 if (NILP (toolbar))
|
|
|
623 {
|
|
|
624 /* The output mechanisms will take care of clearing the former
|
|
|
625 toolbar. */
|
|
|
626 UNGCPRO;
|
|
|
627 return Qnil;
|
|
|
628 }
|
|
|
629
|
|
|
630 if (!CONSP (toolbar))
|
|
|
631 signal_simple_error ("toolbar description must be a list", toolbar);
|
|
|
632
|
|
|
633 /* First synchronize any existing buttons. */
|
|
|
634 while (!NILP (toolbar) && !NILP (buttons))
|
|
|
635 {
|
|
|
636 struct toolbar_button *tb;
|
|
|
637
|
|
|
638 if (NILP (XCAR (toolbar)))
|
|
|
639 {
|
|
|
640 if (pushright_seen)
|
|
|
641 signal_simple_error
|
|
|
642 ("more than one partition (nil) in toolbar description",
|
|
|
643 orig_toolbar);
|
|
|
644 else
|
|
|
645 pushright_seen = 1;
|
|
|
646 }
|
|
|
647 else
|
|
|
648 {
|
|
|
649 tb = XTOOLBAR_BUTTON (buttons);
|
|
|
650 update_toolbar_button (f, tb, XCAR (toolbar), pushright_seen);
|
|
|
651 prev_button = buttons;
|
|
|
652 buttons = tb->next;
|
|
|
653 }
|
|
|
654
|
|
|
655 toolbar = XCDR (toolbar);
|
|
|
656 }
|
|
|
657
|
|
|
658 /* If we hit the end of the toolbar, then clean up any excess
|
|
|
659 buttons and return. */
|
|
|
660 if (NILP (toolbar))
|
|
|
661 {
|
|
|
662 if (!NILP (buttons))
|
|
|
663 {
|
|
2
|
664 /* If this is the case the only thing we saw was a
|
|
0
|
665 pushright marker. */
|
|
|
666 if (EQ (buttons, first_button))
|
|
|
667 {
|
|
|
668 UNGCPRO;
|
|
|
669 return Qnil;
|
|
|
670 }
|
|
|
671 else
|
|
|
672 XTOOLBAR_BUTTON (prev_button)->next = Qnil;
|
|
|
673 }
|
|
|
674 UNGCPRO;
|
|
|
675 return first_button;
|
|
|
676 }
|
|
|
677
|
|
|
678 /* At this point there are more buttons on the toolbar than we
|
|
|
679 actually have in existence. */
|
|
|
680 while (!NILP (toolbar))
|
|
|
681 {
|
|
|
682 Lisp_Object new_button;
|
|
|
683
|
|
|
684 if (NILP (XCAR (toolbar)))
|
|
|
685 {
|
|
|
686 if (pushright_seen)
|
|
|
687 signal_simple_error
|
|
|
688 ("more than one partition (nil) in toolbar description",
|
|
|
689 orig_toolbar);
|
|
|
690 else
|
|
|
691 pushright_seen = 1;
|
|
|
692 }
|
|
|
693 else
|
|
|
694 {
|
|
|
695 new_button = update_toolbar_button (f, NULL, XCAR (toolbar),
|
|
|
696 pushright_seen);
|
|
|
697
|
|
|
698 if (NILP (first_button))
|
|
|
699 {
|
|
|
700 first_button = prev_button = new_button;
|
|
|
701 }
|
|
|
702 else
|
|
|
703 {
|
|
|
704 XTOOLBAR_BUTTON (prev_button)->next = new_button;
|
|
|
705 prev_button = new_button;
|
|
|
706 }
|
|
|
707 }
|
|
|
708
|
|
|
709 toolbar = XCDR (toolbar);
|
|
|
710 }
|
|
|
711
|
|
|
712 UNGCPRO;
|
|
|
713 return first_button;
|
|
|
714 }
|
|
|
715
|
|
|
716 static int
|
|
|
717 set_frame_toolbar (struct frame *f, enum toolbar_pos pos, int first_time_p)
|
|
|
718 {
|
|
|
719 Lisp_Object toolbar, buttons;
|
|
|
720 struct window *w = XWINDOW (FRAME_LAST_NONMINIBUF_WINDOW (f));
|
|
|
721 Lisp_Object buffer = w->buffer;
|
|
|
722 int visible = FRAME_THEORETICAL_TOOLBAR_SIZE (f, pos);
|
|
|
723
|
|
|
724 toolbar = w->toolbar[pos];
|
|
|
725
|
|
|
726 if (NILP (f->toolbar_data[pos]))
|
|
|
727 {
|
|
|
728 struct toolbar_data *td = alloc_lcrecord (sizeof (struct toolbar_data),
|
|
|
729 lrecord_toolbar_data);
|
|
|
730
|
|
|
731 td->last_toolbar_buffer = Qnil;
|
|
|
732 td->toolbar_buttons = Qnil;
|
|
|
733 XSETTOOLBAR_DATA (f->toolbar_data[pos], td);
|
|
|
734 }
|
|
|
735
|
|
|
736 if (visible)
|
|
|
737 buttons = compute_frame_toolbar_buttons (f, pos, toolbar);
|
|
|
738 else
|
|
|
739 buttons = Qnil;
|
|
|
740
|
|
|
741 FRAME_TOOLBAR_DATA (f, pos)->last_toolbar_buffer = buffer;
|
|
|
742 FRAME_TOOLBAR_DATA (f, pos)->toolbar_buttons = buttons;
|
|
|
743
|
|
|
744 return (visible);
|
|
|
745 }
|
|
|
746
|
|
|
747 #define COMPUTE_TOOLBAR_DATA(position) \
|
|
|
748 do \
|
|
|
749 { \
|
|
|
750 local_toolbar_changed = \
|
|
|
751 (f->toolbar_changed \
|
|
|
752 || NILP (f->toolbar_data[position]) \
|
|
|
753 || (!EQ (FRAME_TOOLBAR_DATA (f, position)->last_toolbar_buffer, \
|
|
|
754 XWINDOW (FRAME_LAST_NONMINIBUF_WINDOW (f))->buffer))); \
|
|
|
755 \
|
|
|
756 toolbar_was_visible = \
|
|
|
757 (!NILP (f->toolbar_data[position]) \
|
|
|
758 && !NILP (FRAME_TOOLBAR_DATA (f, position)->toolbar_buttons)); \
|
|
|
759 toolbar_will_be_visible = toolbar_was_visible; \
|
|
|
760 \
|
|
|
761 if (local_toolbar_changed) \
|
|
|
762 toolbar_will_be_visible = \
|
|
|
763 set_frame_toolbar (f, position, first_time_p); \
|
|
|
764 \
|
|
|
765 toolbar_visibility_changed = \
|
|
|
766 (toolbar_was_visible != toolbar_will_be_visible); \
|
|
|
767 \
|
|
|
768 if (toolbar_visibility_changed) \
|
|
|
769 frame_changed_size = 1; \
|
|
|
770 } while (0)
|
|
|
771
|
|
|
772 static void
|
|
|
773 compute_frame_toolbars_data (struct frame *f, int first_time_p)
|
|
|
774 {
|
|
|
775 int local_toolbar_changed;
|
|
|
776 int toolbar_was_visible, toolbar_will_be_visible;
|
|
|
777 int toolbar_visibility_changed;
|
|
|
778 int frame_changed_size = 0;
|
|
|
779
|
|
|
780 COMPUTE_TOOLBAR_DATA (TOP_TOOLBAR);
|
|
|
781 COMPUTE_TOOLBAR_DATA (BOTTOM_TOOLBAR);
|
|
|
782 COMPUTE_TOOLBAR_DATA (LEFT_TOOLBAR);
|
|
|
783 COMPUTE_TOOLBAR_DATA (RIGHT_TOOLBAR);
|
|
|
784
|
|
|
785 /* The frame itself doesn't actually change size, but the usable
|
|
|
786 text area does. All we have to do is call change_frame_size with
|
|
|
787 the current height and width parameters and it will readjust for
|
|
|
788 all changes in the toolbars. */
|
|
|
789 if (frame_changed_size && !first_time_p)
|
|
|
790 change_frame_size (f, FRAME_HEIGHT (f), FRAME_WIDTH (f), 0);
|
|
|
791 }
|
|
|
792 #undef COMPUTE_TOOLBAR_DATA
|
|
|
793
|
|
|
794 void
|
|
|
795 update_frame_toolbars (struct frame *f)
|
|
|
796 {
|
|
|
797 struct device *d = XDEVICE (f->device);
|
|
|
798 Lisp_Object buffer = XWINDOW (FRAME_LAST_NONMINIBUF_WINDOW (f))->buffer;
|
|
|
799
|
|
|
800 /* If the buffer of the selected window is not equal to the
|
|
|
801 last_toolbar_buffer value for any of the toolbars, then the
|
|
|
802 toolbars need to be recomputed. */
|
|
|
803 if ((HAS_DEVMETH_P (d, output_frame_toolbars))
|
|
|
804 && (f->toolbar_changed
|
|
|
805 || !EQ (FRAME_TOOLBAR_BUFFER (f, TOP_TOOLBAR), buffer)
|
|
|
806 || !EQ (FRAME_TOOLBAR_BUFFER (f, BOTTOM_TOOLBAR), buffer)
|
|
|
807 || !EQ (FRAME_TOOLBAR_BUFFER (f, LEFT_TOOLBAR), buffer)
|
|
|
808 || !EQ (FRAME_TOOLBAR_BUFFER (f, RIGHT_TOOLBAR), buffer)))
|
|
|
809 {
|
|
|
810 /* Removed the check for the minibuffer here. We handle this
|
|
|
811 more correctly now by consistently using
|
|
|
812 FRAME_LAST_NONMINIBUF_WINDOW instead of FRAME_SELECTED_WINDOW
|
|
|
813 throughout the toolbar code. */
|
|
|
814 compute_frame_toolbars_data (f, 0);
|
|
|
815
|
|
|
816 DEVMETH (d, output_frame_toolbars, (f));
|
|
|
817 }
|
|
|
818
|
|
|
819 f->toolbar_changed = 0;
|
|
|
820 }
|
|
|
821
|
|
|
822 void
|
|
|
823 init_frame_toolbars (struct frame *f)
|
|
|
824 {
|
|
|
825 struct device *d = XDEVICE (f->device);
|
|
|
826
|
|
|
827 /* If there isn't any output routine, then this device type doesn't
|
|
|
828 support toolbars. */
|
|
|
829 if (HAS_DEVMETH_P (d, output_frame_toolbars))
|
|
|
830 {
|
|
|
831 Lisp_Object frame = Qnil;
|
|
|
832
|
|
|
833 compute_frame_toolbars_data (f, 1);
|
|
|
834 XSETFRAME (frame, f);
|
|
|
835 call_critical_lisp_code (XDEVICE (FRAME_DEVICE (f)),
|
|
|
836 Qinit_toolbar_from_resources,
|
|
|
837 frame);
|
|
|
838 MAYBE_DEVMETH (d, initialize_frame_toolbars, (f));
|
|
|
839 }
|
|
|
840 }
|
|
|
841
|
|
|
842 void
|
|
|
843 init_device_toolbars (struct device *d)
|
|
|
844 {
|
|
|
845 Lisp_Object device = Qnil;
|
|
|
846
|
|
|
847 XSETDEVICE (device, d);
|
|
|
848 if (HAS_DEVMETH_P (d, output_frame_toolbars))
|
|
|
849 call_critical_lisp_code (d,
|
|
|
850 Qinit_toolbar_from_resources,
|
|
|
851 device);
|
|
|
852 }
|
|
|
853
|
|
|
854 void
|
|
|
855 init_global_toolbars (struct device *d)
|
|
|
856 {
|
|
|
857 if (HAS_DEVMETH_P (d, output_frame_toolbars))
|
|
|
858 call_critical_lisp_code (d,
|
|
|
859 Qinit_toolbar_from_resources,
|
|
|
860 Qglobal);
|
|
|
861 }
|
|
|
862
|
|
|
863 void
|
|
|
864 free_frame_toolbars (struct frame *f)
|
|
|
865 {
|
|
|
866 /* If we had directly allocated any memory for the toolbars instead
|
|
|
867 of using all Lisp_Objects this is where we would now free it. */
|
|
|
868
|
|
|
869 MAYBE_FRAMEMETH (f, free_frame_toolbars, (f));
|
|
|
870 }
|
|
|
871
|
|
|
872 void
|
|
|
873 get_toolbar_coords (struct frame *f, enum toolbar_pos pos, int *x, int *y,
|
|
|
874 int *width, int *height, int *vert, int for_layout)
|
|
|
875 {
|
|
|
876 int visible_top_toolbar_height, visible_bottom_toolbar_height;
|
|
|
877 int adjust = (for_layout ? 1 : 0);
|
|
|
878
|
|
|
879 /* The top and bottom toolbars take precedence over the left and
|
|
|
880 right. */
|
|
|
881 visible_top_toolbar_height = (FRAME_REAL_TOP_TOOLBAR_VISIBLE (f)
|
|
|
882 ? FRAME_REAL_TOP_TOOLBAR_HEIGHT (f)
|
|
|
883 : 0);
|
|
|
884 visible_bottom_toolbar_height = (FRAME_REAL_BOTTOM_TOOLBAR_VISIBLE (f)
|
|
|
885 ? FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f)
|
|
|
886 : 0);
|
|
|
887
|
|
|
888 /* We adjust the width and height by one to give us a narrow border
|
|
|
889 at the outside edges. However, when we are simply determining
|
|
|
890 toolbar location we don't want to do that. */
|
|
|
891
|
|
|
892 switch (pos)
|
|
|
893 {
|
|
|
894 case TOP_TOOLBAR:
|
|
|
895 *x = 1;
|
|
|
896 *y = 0; /* #### should be 1 if no menubar */
|
|
|
897 *width = FRAME_PIXWIDTH (f) - 2;
|
|
|
898 *height = FRAME_REAL_TOP_TOOLBAR_HEIGHT (f) - adjust;
|
|
|
899 *vert = 0;
|
|
|
900 break;
|
|
|
901 case BOTTOM_TOOLBAR:
|
|
|
902 *x = 1;
|
|
|
903 *y = FRAME_PIXHEIGHT (f) - FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f);
|
|
|
904 *width = FRAME_PIXWIDTH (f) - 2;
|
|
|
905 *height = FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f) - adjust;
|
|
|
906 *vert = 0;
|
|
|
907 break;
|
|
|
908 case LEFT_TOOLBAR:
|
|
|
909 *x = 1;
|
|
|
910 *y = visible_top_toolbar_height;
|
|
|
911 *width = FRAME_REAL_LEFT_TOOLBAR_WIDTH (f) - adjust;
|
|
|
912 *height = (FRAME_PIXHEIGHT (f) - visible_top_toolbar_height -
|
|
|
913 visible_bottom_toolbar_height - 1);
|
|
|
914 *vert = 1;
|
|
|
915 break;
|
|
|
916 case RIGHT_TOOLBAR:
|
|
|
917 *x = FRAME_PIXWIDTH (f) - FRAME_REAL_RIGHT_TOOLBAR_WIDTH (f);
|
|
|
918 *y = visible_top_toolbar_height;
|
|
|
919 *width = FRAME_REAL_RIGHT_TOOLBAR_WIDTH (f) - adjust;
|
|
|
920 *height = (FRAME_PIXHEIGHT (f) - visible_top_toolbar_height -
|
|
|
921 visible_bottom_toolbar_height);
|
|
|
922 *vert = 1;
|
|
|
923 break;
|
|
|
924 default:
|
|
|
925 abort ();
|
|
|
926 }
|
|
|
927 }
|
|
|
928
|
|
|
929 #define CHECK_TOOLBAR(pos) \
|
|
|
930 do \
|
|
|
931 { \
|
|
|
932 get_toolbar_coords (f, pos, &x, &y, &width, &height, &vert, 0); \
|
|
|
933 if ((x_coord >= x) && (x_coord < (x + width))) \
|
|
|
934 { \
|
|
|
935 if ((y_coord >= y) && (y_coord < (y + height))) \
|
|
|
936 { \
|
|
|
937 return (FRAME_TOOLBAR_DATA (f, pos)->toolbar_buttons); \
|
|
|
938 } \
|
|
|
939 } \
|
|
|
940 } while (0)
|
|
|
941
|
|
|
942 static Lisp_Object
|
|
|
943 toolbar_buttons_at_pixpos (struct frame *f, int x_coord, int y_coord)
|
|
|
944 {
|
|
|
945 int x, y, width, height, vert;
|
|
|
946
|
|
|
947 if (FRAME_REAL_TOP_TOOLBAR_VISIBLE (f))
|
|
|
948 CHECK_TOOLBAR (TOP_TOOLBAR);
|
|
|
949 if (FRAME_REAL_BOTTOM_TOOLBAR_VISIBLE (f))
|
|
|
950 CHECK_TOOLBAR (BOTTOM_TOOLBAR);
|
|
|
951 if (FRAME_REAL_LEFT_TOOLBAR_VISIBLE (f))
|
|
|
952 CHECK_TOOLBAR (LEFT_TOOLBAR);
|
|
|
953 if (FRAME_REAL_RIGHT_TOOLBAR_VISIBLE (f))
|
|
|
954 CHECK_TOOLBAR (RIGHT_TOOLBAR);
|
|
|
955
|
|
|
956 return Qnil;
|
|
|
957 }
|
|
|
958 #undef CHECK_TOOLBAR
|
|
|
959
|
|
|
960 /* The device dependent code actually does the work of positioning the
|
|
|
961 buttons, but we are free to access that information at this
|
|
|
962 level. */
|
|
|
963 Lisp_Object
|
|
|
964 toolbar_button_at_pixpos (struct frame *f, int x_coord, int y_coord)
|
|
|
965 {
|
|
|
966 Lisp_Object buttons = toolbar_buttons_at_pixpos (f, x_coord, y_coord);
|
|
|
967
|
|
|
968 if (NILP (buttons))
|
|
|
969 return Qnil;
|
|
|
970
|
|
|
971 while (!NILP (buttons))
|
|
|
972 {
|
|
|
973 struct toolbar_button *tb = XTOOLBAR_BUTTON (buttons);
|
|
|
974
|
|
|
975 if ((x_coord >= tb->x) && (x_coord < (tb->x + tb->width)))
|
|
|
976 {
|
|
|
977 if ((y_coord >= tb->y) && (y_coord < (tb->y + tb->height)))
|
|
|
978 {
|
|
|
979 /* If we are over a blank, return nil. */
|
|
|
980 if (tb->blank)
|
|
|
981 return Qnil;
|
|
|
982 else
|
|
|
983 return buttons;
|
|
|
984 }
|
|
|
985 }
|
|
|
986
|
|
|
987 buttons = tb->next;
|
|
|
988 }
|
|
|
989
|
|
|
990 /* We must be over a blank in the toolbar. */
|
|
|
991 return Qnil;
|
|
|
992 }
|
|
|
993
|
|
|
994
|
|
|
995 /************************************************************************/
|
|
|
996 /* Toolbar specifier type */
|
|
|
997 /************************************************************************/
|
|
|
998
|
|
|
999 DEFINE_SPECIFIER_TYPE (toolbar);
|
|
|
1000
|
|
|
1001 #define CTB_ERROR(msg) \
|
|
|
1002 do \
|
|
|
1003 { \
|
|
|
1004 maybe_signal_simple_error (msg, button, Qtoolbar, errb); \
|
|
|
1005 RETURN__ Qnil; \
|
|
|
1006 } \
|
|
|
1007 while (0)
|
|
|
1008
|
|
|
1009 /* Returns Q_style if key was :style, Qt if ok otherwise, Qnil if error. */
|
|
|
1010 static Lisp_Object
|
|
|
1011 check_toolbar_button_keywords (Lisp_Object button, Lisp_Object key,
|
|
|
1012 Lisp_Object val, Error_behavior errb)
|
|
|
1013 {
|
|
|
1014 if (!KEYWORDP (key))
|
|
|
1015 {
|
|
|
1016 maybe_signal_simple_error_2 ("not a keyword", key, button, Qtoolbar,
|
|
|
1017 errb);
|
|
|
1018 return Qnil;
|
|
|
1019 }
|
|
|
1020
|
|
|
1021 if (EQ (key, Q_style))
|
|
|
1022 {
|
|
|
1023 if (!EQ (val, Q2D)
|
|
|
1024 && !EQ (val, Q3D)
|
|
|
1025 && !EQ (val, Q2d)
|
|
|
1026 && !EQ (val, Q3d))
|
|
|
1027 CTB_ERROR ("unrecognized toolbar blank style");
|
|
|
1028
|
|
|
1029 return Q_style;
|
|
|
1030 }
|
|
|
1031 else if (EQ (key, Q_size))
|
|
|
1032 {
|
|
|
1033 if (!NATNUMP (val))
|
|
|
1034 CTB_ERROR ("invalid toolbar blank size");
|
|
|
1035 }
|
|
|
1036 else
|
|
|
1037 {
|
|
|
1038 CTB_ERROR ("invalid toolbar blank keyword");
|
|
|
1039 }
|
|
|
1040
|
|
|
1041 return Qt;
|
|
|
1042 }
|
|
|
1043
|
|
|
1044 /* toolbar button spec is [pixmap-pair function enabled-p help]
|
|
|
1045 or [:style 2d-or-3d :size width-or-height] */
|
|
|
1046
|
|
|
1047 DEFUN ("check-toolbar-button-syntax", Fcheck_toolbar_button_syntax,
|
|
|
1048 Scheck_toolbar_button_syntax, 1, 2, 0 /*
|
|
|
1049 Verify the syntax of entry BUTTON in a toolbar description list.
|
|
|
1050 If you want to verify the syntax of a toolbar description list as a
|
|
|
1051 whole, use `check-valid-instantiator' with a specifier type of 'toolbar.
|
|
|
1052 */ )
|
|
|
1053 (button, no_error)
|
|
|
1054 Lisp_Object button, no_error;
|
|
|
1055 {
|
|
|
1056 Lisp_Object *elt, glyphs, value;
|
|
|
1057 int len;
|
|
|
1058 Error_behavior errb = decode_error_behavior_flag (no_error);
|
|
|
1059
|
|
|
1060 if (!VECTORP (button))
|
|
|
1061 CTB_ERROR ("toolbar button descriptors must be vectors");
|
|
|
1062 elt = vector_data (XVECTOR (button));
|
|
|
1063
|
|
|
1064 if (vector_length (XVECTOR (button)) == 2)
|
|
|
1065 {
|
|
|
1066 if (!EQ (Q_style, check_toolbar_button_keywords (button, elt[0],
|
|
|
1067 elt[1], errb)))
|
|
|
1068 CTB_ERROR ("must specify toolbar blank style");
|
|
|
1069
|
|
|
1070 return Qt;
|
|
|
1071 }
|
|
|
1072
|
|
|
1073 if (vector_length (XVECTOR (button)) != 4)
|
|
|
1074 CTB_ERROR ("toolbar button descriptors must be 2 or 4 long");
|
|
|
1075
|
|
|
1076 /* The first element must be a list of glyphs of length 1-6. The
|
|
|
1077 first entry is the pixmap for the up state, the second for the
|
|
|
1078 down state, the third for the disabled state, the fourth for the
|
|
|
1079 captioned up state, the fifth for the captioned down state and
|
|
|
1080 the sixth for the captioned disabled state. Only the up state is
|
|
|
1081 mandatory. */
|
|
|
1082 if (!CONSP (elt[0]))
|
|
|
1083 {
|
|
|
1084 /* We can't check the buffer-local here because we don't know
|
|
|
1085 which buffer to check in. #### I think this is a bad thing.
|
|
|
1086 See if we can't get enough information to this function so
|
|
|
1087 that it can check.
|
|
|
1088
|
|
|
1089 #### Wrong. We shouldn't be checking the value at all here.
|
|
|
1090 The user might set or change the value at any time. */
|
|
|
1091 value = Fsymbol_value (elt[0]);
|
|
|
1092
|
|
|
1093 if (!CONSP (value))
|
|
|
1094 {
|
|
|
1095 if (KEYWORDP (elt[0]))
|
|
|
1096 {
|
|
|
1097 int fsty = 0;
|
|
|
1098
|
|
|
1099 if (EQ (Q_style, check_toolbar_button_keywords (button, elt[0],
|
|
|
1100 elt[1],
|
|
|
1101 errb)))
|
|
|
1102 fsty++;
|
|
|
1103
|
|
|
1104 if (EQ (Q_style, check_toolbar_button_keywords (button, elt[2],
|
|
|
1105 elt[3],
|
|
|
1106 errb)))
|
|
|
1107 fsty++;
|
|
|
1108
|
|
|
1109 if (!fsty)
|
|
|
1110 CTB_ERROR ("must specify toolbar blank style");
|
|
|
1111 else if (EQ (elt[0], elt[2]))
|
|
|
1112 CTB_ERROR
|
|
|
1113 ("duplicate keywords in toolbar button blank description");
|
|
|
1114
|
|
|
1115 return Qt;
|
|
|
1116 }
|
|
|
1117 else
|
|
|
1118 CTB_ERROR ("first element of button must be a list (of glyphs)");
|
|
|
1119 }
|
|
|
1120 }
|
|
|
1121 else
|
|
|
1122 value = elt[0];
|
|
|
1123
|
|
|
1124 len = XINT (Flength (value));
|
|
|
1125 if (len < 1)
|
|
|
1126 CTB_ERROR ("toolbar button glyph list must have at least 1 entry");
|
|
|
1127
|
|
|
1128 if (len > 6)
|
|
|
1129 CTB_ERROR ("toolbar button glyph list can have at most 6 entries");
|
|
|
1130
|
|
|
1131 glyphs = value;
|
|
|
1132 while (!NILP (glyphs))
|
|
|
1133 {
|
|
|
1134 if (!GLYPHP (XCAR (glyphs)))
|
|
|
1135 {
|
|
|
1136 /* We allow nil for the down and disabled glyphs but not for
|
|
|
1137 the up glyph. */
|
|
|
1138 if (EQ (glyphs, value) || !NILP (XCAR (glyphs)))
|
|
|
1139 {
|
|
|
1140 CTB_ERROR
|
|
|
1141 ("all elements of toolbar button glyph list must be glyphs.");
|
|
|
1142 }
|
|
|
1143 }
|
|
|
1144 glyphs = XCDR (glyphs);
|
|
|
1145 }
|
|
|
1146
|
|
|
1147 /* The second element is the function to run when the button is
|
|
|
1148 activated. We do not do any checking on it because it is legal
|
|
|
1149 for the function to not be defined until after the toolbar is.
|
|
|
1150 It is the user's problem to get this right.
|
|
|
1151
|
|
|
1152 The third element is either a boolean indicating the enabled
|
|
|
1153 status or a function used to determine it. Again, it is the
|
|
|
1154 user's problem if this is wrong.
|
|
|
1155
|
|
|
1156 The fourth element, if not nil, must be a string which will be
|
|
|
1157 displayed as the help echo. */
|
|
|
1158
|
|
|
1159 /* #### This should be allowed to be a function returning a string
|
|
|
1160 as well as just a string. */
|
|
|
1161 if (!NILP (elt[3]) && !STRINGP (elt[3]))
|
|
|
1162 CTB_ERROR ("toolbar button help echo string must be a string");
|
|
|
1163
|
|
|
1164 return Qt;
|
|
|
1165 }
|
|
|
1166 #undef CTB_ERROR
|
|
|
1167
|
|
|
1168 static void
|
|
|
1169 toolbar_validate (Lisp_Object instantiator)
|
|
|
1170 {
|
|
|
1171 int pushright_seen = 0;
|
|
|
1172 Lisp_Object rest;
|
|
|
1173
|
|
|
1174 if (NILP (instantiator))
|
|
|
1175 return;
|
|
|
1176
|
|
|
1177 if (!CONSP (instantiator))
|
|
|
1178 signal_simple_error ("toolbar spec must be list or nil", instantiator);
|
|
|
1179
|
|
|
1180 for (rest = instantiator; !NILP (rest); rest = XCDR (rest))
|
|
|
1181 {
|
|
|
1182 if (!CONSP (rest))
|
|
|
1183 signal_simple_error ("bad list in toolbar spec", instantiator);
|
|
|
1184
|
|
|
1185 if (NILP (XCAR (rest)))
|
|
|
1186 {
|
|
|
1187 if (pushright_seen)
|
|
|
1188 error
|
|
|
1189 ("more than one partition (nil) in instantiator description");
|
|
|
1190 else
|
|
|
1191 pushright_seen = 1;
|
|
|
1192 }
|
|
|
1193 else
|
|
|
1194 Fcheck_toolbar_button_syntax (XCAR (rest), Qnil);
|
|
|
1195 }
|
|
|
1196 }
|
|
|
1197
|
|
|
1198 static void
|
|
|
1199 toolbar_after_change (Lisp_Object specifier, Lisp_Object locale)
|
|
|
1200 {
|
|
|
1201 /* #### This is overkill. I really need to rethink the after-change
|
|
|
1202 functions to make them easier to use. */
|
|
|
1203 MARK_TOOLBAR_CHANGED;
|
|
|
1204 }
|
|
|
1205
|
|
|
1206 DEFUN ("toolbar-specifier-p", Ftoolbar_specifier_p,
|
|
|
1207 Stoolbar_specifier_p, 1, 1, 0 /*
|
|
|
1208 Return non-nil if OBJECT is a toolbar specifier.
|
|
|
1209 Toolbar specifiers are used to specify the format of a toolbar.
|
|
|
1210 The values of the variables `default-toolbar', `top-toolbar',
|
|
|
1211 `left-toolbar', `right-toolbar', and `bottom-toolbar' are always
|
|
|
1212 toolbar specifiers.
|
|
|
1213
|
|
|
1214 Valid toolbar instantiators are called \"toolbar descriptors\"
|
|
|
1215 and are lists of vectors. See `default-toolbar' for a description
|
|
|
1216 of the exact format.
|
|
|
1217 */ )
|
|
|
1218 (object)
|
|
|
1219 Lisp_Object object;
|
|
|
1220 {
|
|
|
1221 return (TOOLBAR_SPECIFIERP (object) ? Qt : Qnil);
|
|
|
1222 }
|
|
|
1223
|
|
|
1224
|
|
|
1225 static void
|
|
|
1226 toolbar_specs_changed (Lisp_Object specifier, struct window *w,
|
|
|
1227 Lisp_Object oldval)
|
|
|
1228 {
|
|
|
1229 /* This could be smarter but I doubt that it would make any
|
|
|
1230 noticable difference given the infrequency with which this is
|
|
|
1231 probably going to be called.
|
|
|
1232 */
|
|
|
1233 MARK_TOOLBAR_CHANGED;
|
|
|
1234 }
|
|
|
1235
|
|
|
1236 static void
|
|
|
1237 default_toolbar_specs_changed (Lisp_Object specifier, struct window *w,
|
|
|
1238 Lisp_Object oldval)
|
|
|
1239 {
|
|
|
1240 enum toolbar_pos pos = decode_toolbar_position (Vdefault_toolbar_position);
|
|
|
1241
|
|
|
1242 Fset_specifier_dirty_flag (Vtoolbar[pos]);
|
|
|
1243 }
|
|
|
1244
|
|
|
1245 static void
|
|
|
1246 toolbar_size_changed_in_frame (Lisp_Object specifier, struct frame *f,
|
|
|
1247 Lisp_Object oldval)
|
|
|
1248 {
|
|
2
|
1249 int pos;
|
|
0
|
1250
|
|
2
|
1251 for (pos = 0; pos < countof (Vtoolbar_size); pos++)
|
|
|
1252 if (EQ (specifier, Vtoolbar_size[(enum toolbar_pos) pos]))
|
|
0
|
1253 break;
|
|
|
1254
|
|
2
|
1255 assert (pos < countof (Vtoolbar_size));
|
|
0
|
1256
|
|
|
1257 MAYBE_FRAMEMETH (f, toolbar_size_changed_in_frame,
|
|
|
1258 (f, pos, oldval));
|
|
|
1259
|
|
|
1260 /* Let redisplay know that something has possibly changed. */
|
|
|
1261 MARK_TOOLBAR_CHANGED;
|
|
|
1262 }
|
|
|
1263
|
|
|
1264 static void
|
|
|
1265 toolbar_visible_p_changed_in_frame (Lisp_Object specifier, struct frame *f,
|
|
|
1266 Lisp_Object oldval)
|
|
|
1267 {
|
|
2
|
1268 int pos;
|
|
0
|
1269
|
|
2
|
1270 for (pos = 0; pos < countof (Vtoolbar_visible_p); pos++)
|
|
|
1271 if (EQ (specifier, Vtoolbar_visible_p[(enum toolbar_pos) pos]))
|
|
0
|
1272 break;
|
|
|
1273
|
|
2
|
1274 assert (pos < countof (Vtoolbar_visible_p));
|
|
0
|
1275
|
|
|
1276 MAYBE_FRAMEMETH (f, toolbar_visible_p_changed_in_frame,
|
|
|
1277 (f, pos, oldval));
|
|
|
1278
|
|
|
1279 /* Let redisplay know that something has possibly changed. */
|
|
|
1280 MARK_TOOLBAR_CHANGED;
|
|
|
1281 }
|
|
|
1282
|
|
|
1283 static void
|
|
|
1284 default_toolbar_size_changed_in_frame (Lisp_Object specifier, struct frame *f,
|
|
|
1285 Lisp_Object oldval)
|
|
|
1286 {
|
|
|
1287 enum toolbar_pos pos = decode_toolbar_position (Vdefault_toolbar_position);
|
|
|
1288
|
|
|
1289 Fset_specifier_dirty_flag (Vtoolbar_size[pos]);
|
|
|
1290
|
|
|
1291 /* Let redisplay know that something has possibly changed. */
|
|
|
1292 MARK_TOOLBAR_CHANGED;
|
|
|
1293 }
|
|
|
1294
|
|
|
1295 static void
|
|
|
1296 default_toolbar_visible_p_changed_in_frame (Lisp_Object specifier,
|
|
|
1297 struct frame *f,
|
|
|
1298 Lisp_Object oldval)
|
|
|
1299 {
|
|
|
1300 enum toolbar_pos pos = decode_toolbar_position (Vdefault_toolbar_position);
|
|
|
1301
|
|
|
1302 Fset_specifier_dirty_flag (Vtoolbar_visible_p[pos]);
|
|
|
1303
|
|
|
1304 /* Let redisplay know that something has possibly changed. */
|
|
|
1305 MARK_TOOLBAR_CHANGED;
|
|
|
1306 }
|
|
|
1307
|
|
|
1308
|
|
|
1309 static void
|
|
|
1310 toolbar_buttons_captioned_p_changed (Lisp_Object specifier, struct window *w,
|
|
|
1311 Lisp_Object oldval)
|
|
|
1312 {
|
|
|
1313 /* This could be smarter but I doubt that it would make any
|
|
|
1314 noticable difference given the infrequency with which this is
|
|
|
1315 probably going to be called. */
|
|
|
1316 MARK_TOOLBAR_CHANGED;
|
|
|
1317 }
|
|
|
1318
|
|
|
1319
|
|
|
1320 void
|
|
|
1321 syms_of_toolbar (void)
|
|
|
1322 {
|
|
|
1323 defsymbol (&Qtoolbar_buttonp, "toolbar-button-p");
|
|
|
1324 defsymbol (&Q2D, "2D");
|
|
|
1325 defsymbol (&Q3D, "3D");
|
|
|
1326 defsymbol (&Q2d, "2d");
|
|
|
1327 defsymbol (&Q3d, "3d");
|
|
|
1328 defsymbol (&Q_size, ":size"); Fset (Q_size, Q_size);
|
|
|
1329
|
|
|
1330 defsymbol (&Qinit_toolbar_from_resources, "init-toolbar-from-resources");
|
|
|
1331 defsubr (&Stoolbar_button_p);
|
|
|
1332 defsubr (&Stoolbar_button_callback);
|
|
|
1333 defsubr (&Stoolbar_button_help_string);
|
|
|
1334 defsubr (&Stoolbar_button_enabled_p);
|
|
|
1335 defsubr (&Sset_toolbar_button_down_flag);
|
|
|
1336 defsubr (&Scheck_toolbar_button_syntax);
|
|
|
1337 defsubr (&Sset_default_toolbar_position);
|
|
|
1338 defsubr (&Sdefault_toolbar_position);
|
|
|
1339 defsubr (&Stoolbar_specifier_p);
|
|
|
1340 }
|
|
|
1341
|
|
|
1342 void
|
|
|
1343 vars_of_toolbar (void)
|
|
|
1344 {
|
|
|
1345 staticpro (&Vdefault_toolbar_position);
|
|
|
1346 Vdefault_toolbar_position = Qtop;
|
|
|
1347
|
|
|
1348 #ifdef HAVE_WINDOW_SYSTEM
|
|
|
1349 Fprovide (Qtoolbar);
|
|
|
1350 #endif
|
|
|
1351 }
|
|
|
1352
|
|
|
1353 void
|
|
|
1354 specifier_type_create_toolbar (void)
|
|
|
1355 {
|
|
|
1356 INITIALIZE_SPECIFIER_TYPE (toolbar, "toolbar", "toolbar-specifier-p");
|
|
|
1357
|
|
|
1358 SPECIFIER_HAS_METHOD (toolbar, validate);
|
|
|
1359 SPECIFIER_HAS_METHOD (toolbar, after_change);
|
|
|
1360 }
|
|
|
1361
|
|
|
1362 void
|
|
|
1363 specifier_vars_of_toolbar (void)
|
|
|
1364 {
|
|
|
1365 Lisp_Object elt;
|
|
|
1366
|
|
|
1367 DEFVAR_SPECIFIER ("default-toolbar", &Vdefault_toolbar /*
|
|
|
1368 Specifier for a fallback toolbar.
|
|
|
1369 Use `set-specifier' to change this.
|
|
|
1370
|
|
|
1371 The position of this toolbar is specified in the function
|
|
|
1372 `default-toolbar-position'. If the corresponding position-specific
|
|
|
1373 toolbar (e.g. `top-toolbar' if `default-toolbar-position' is 'top)
|
|
|
1374 does not specify a toolbar in a particular domain (usually a window),
|
|
|
1375 then the value of `default-toolbar' in that domain, if any, will be
|
|
|
1376 used instead.
|
|
|
1377
|
|
|
1378 Note that the toolbar at any particular position will not be
|
|
|
1379 displayed unless its visibility flag is true and its thickness
|
|
|
1380 \(width or height, depending on orientation) is non-zero. The
|
|
|
1381 visibility is controlled by the specifiers `top-toolbar-visible-p',
|
|
|
1382 `bottom-toolbar-visible-p', `left-toolbar-visible-p', and
|
|
|
1383 `right-toolbar-visible-p', and the thickness is controlled by the
|
|
|
1384 specifiers `top-toolbar-height', `bottom-toolbar-height',
|
|
|
1385 `left-toolbar-width', and `right-toolbar-width'.
|
|
|
1386
|
|
|
1387 Note that one of the four visibility specifiers inherits from
|
|
|
1388 `default-toolbar-visibility' and one of the four thickness
|
|
|
1389 specifiers inherits from either `default-toolbar-width' or
|
|
|
1390 `default-toolbar-height' (depending on orientation), just
|
|
|
1391 like for the toolbar description specifiers (e.g. `top-toolbar')
|
|
|
1392 mentioned above.
|
|
|
1393
|
|
|
1394 Therefore, if you are setting `default-toolbar', you should control
|
|
|
1395 the visibility and thickness using `default-toolbar-visible-p',
|
|
|
1396 `default-toolbar-width', and `default-toolbar-height', rather than
|
|
|
1397 using position-specific specifiers. That way, you will get sane
|
|
|
1398 behavior if the user changes the default toolbar position.
|
|
|
1399
|
|
|
1400 The format of the instantiator for a toolbar is a list of
|
|
|
1401 toolbar-button-descriptors. Each toolbar-button-descriptor
|
|
|
1402 is a vector in one of the following formats:
|
|
|
1403
|
|
|
1404 [GLYPH-LIST FUNCTION ENABLED-P HELP] or
|
|
|
1405 [:style 2D-OR-3D] or
|
|
|
1406 [:style 2D-OR-3D :size WIDTH-OR-HEIGHT] or
|
|
|
1407 [:size WIDTH-OR-HEIGHT :style 2D-OR-3D]
|
|
|
1408
|
|
|
1409 Optionally, one of the toolbar-button-descriptors may be nil
|
|
|
1410 instead of a vector; this signifies the division between
|
|
|
1411 the toolbar buttons that are to be displayed flush-left,
|
|
|
1412 and the buttons to be displayed flush-right.
|
|
|
1413
|
|
|
1414 The first vector format above specifies a normal toolbar button;
|
|
|
1415 the others specify blank areas in the toolbar.
|
|
|
1416
|
|
|
1417 For the first vector format:
|
|
|
1418
|
|
|
1419 -- GLYPH-LIST should be a list of one to six glyphs (as created by
|
|
|
1420 `make-glyph') or a symbol whose value is such a list. The first
|
|
|
1421 glyph, which must be provided, is the glyph used to display the
|
|
|
1422 toolbar button when it is in the \"up\" (not pressed) state. The
|
|
|
1423 optional second glyph is for displaying the button when it is in
|
|
|
1424 the \"down\" (pressed) state. The optional third glyph is for when
|
|
|
1425 the button is disabled. The optional fourth, fifth and sixth glyphs
|
|
|
1426 are used to specify captioned versions for the up, down and disabled
|
|
|
1427 states respectively. The function `toolbar-make-button-list' is
|
|
|
1428 useful in creating these glyph lists. The specifier variable
|
|
|
1429 `toolbar-buttons-captioned-p' controls which glyphs are actually used.
|
|
|
1430
|
|
|
1431 -- Even if you do not provide separate down-state and disabled-state
|
|
|
1432 glyphs, the user will still get visual feedback to indicate which
|
|
|
1433 state the button is in. Buttons in the up-state are displayed
|
|
|
1434 with a shadowed border that gives a raised appearance to the
|
|
|
1435 button. Buttons in the down-state are displayed with shadows that
|
|
|
1436 give a recessed appearance. Buttons in the disabled state are
|
|
|
1437 displayed with no shadows, giving a 2-d effect.
|
|
|
1438
|
|
|
1439 -- If some of the toolbar glyphs are not provided, they inherit as follows:
|
|
|
1440
|
|
|
1441 UP: up
|
|
|
1442 DOWN: down -> up
|
|
|
1443 DISABLED: disabled -> up
|
|
|
1444 CAP-UP: cap-up -> up
|
|
|
1445 CAP-DOWN: cap-down -> cap-up -> down -> up
|
|
|
1446 CAP-DISABLED: cap-disabled -> cap-up -> disabled -> up
|
|
|
1447
|
|
|
1448 -- The second element FUNCTION is a function to be called when the
|
|
|
1449 toolbar button is activated (i.e. when the mouse is released over
|
|
|
1450 the toolbar button, if the press occurred in the toolbar). It
|
|
|
1451 can be any form accepted by `call-interactively', since this is
|
|
|
1452 how it is invoked.
|
|
|
1453
|
|
|
1454 -- The third element ENABLED-P specifies whether the toolbar button
|
|
|
1455 is enabled (disabled buttons do nothing when they are activated,
|
|
|
1456 and are displayed differently; see above). It should be either
|
|
|
1457 a boolean or a form that evaluates to a boolean.
|
|
|
1458
|
|
|
1459 -- The fourth element HELP, if non-nil, should be a string. This
|
|
|
1460 string is displayed in the echo area when the mouse passes over
|
|
|
1461 the toolbar button.
|
|
|
1462
|
|
|
1463 For the other vector formats (specifying blank areas of the toolbar):
|
|
|
1464
|
|
|
1465 -- 2D-OR-3D should be one of the symbols '2d or '3d, indicating
|
|
|
1466 whether the area is displayed with shadows (giving it a raised,
|
|
|
1467 3-d appearance) or without shadows (giving it a flat appearance).
|
|
|
1468
|
|
|
1469 -- WIDTH-OR-HEIGHT specifies the length, in pixels, of the blank
|
|
|
1470 area. If omitted, it defaults to a device-specific value
|
|
|
1471 (8 pixels for X devices).
|
|
|
1472 */ );
|
|
|
1473
|
|
|
1474 Vdefault_toolbar = Fmake_specifier (Qtoolbar);
|
|
|
1475 /* #### It would be even nicer if the specifier caching
|
|
|
1476 automatically knew about specifier fallbacks, so we didn't
|
|
|
1477 have to do it ourselves. */
|
|
|
1478 set_specifier_caching (Vdefault_toolbar,
|
|
|
1479 slot_offset (struct window,
|
|
|
1480 default_toolbar),
|
|
|
1481 default_toolbar_specs_changed,
|
|
|
1482 0, 0);
|
|
|
1483
|
|
|
1484 DEFVAR_SPECIFIER ("top-toolbar",
|
|
|
1485 &Vtoolbar[TOP_TOOLBAR] /*
|
|
|
1486 Specifier for the toolbar at the top of the frame.
|
|
|
1487 Use `set-specifier' to change this.
|
|
|
1488 See `default-toolbar' for a description of a valid toolbar instantiator.
|
|
|
1489 */ );
|
|
|
1490 Vtoolbar[TOP_TOOLBAR] = Fmake_specifier (Qtoolbar);
|
|
|
1491 set_specifier_caching (Vtoolbar[TOP_TOOLBAR],
|
|
|
1492 slot_offset (struct window,
|
|
|
1493 toolbar[TOP_TOOLBAR]),
|
|
|
1494 toolbar_specs_changed,
|
|
|
1495 0, 0);
|
|
|
1496
|
|
|
1497 DEFVAR_SPECIFIER ("bottom-toolbar",
|
|
|
1498 &Vtoolbar[BOTTOM_TOOLBAR] /*
|
|
|
1499 Specifier for the toolbar at the bottom of the frame.
|
|
|
1500 Use `set-specifier' to change this.
|
|
|
1501 See `default-toolbar' for a description of a valid toolbar instantiator.
|
|
|
1502
|
|
|
1503 Note that, unless the `default-toolbar-position' is `bottom', by
|
|
|
1504 default the height of the bottom toolbar (controlled by
|
|
|
1505 `bottom-toolbar-height') is 0; thus, a bottom toolbar will not be
|
|
|
1506 displayed even if you provide a value for `bottom-toolbar'.
|
|
|
1507 */ );
|
|
|
1508 Vtoolbar[BOTTOM_TOOLBAR] = Fmake_specifier (Qtoolbar);
|
|
|
1509 set_specifier_caching (Vtoolbar[BOTTOM_TOOLBAR],
|
|
|
1510 slot_offset (struct window,
|
|
|
1511 toolbar[BOTTOM_TOOLBAR]),
|
|
|
1512 toolbar_specs_changed,
|
|
|
1513 0, 0);
|
|
|
1514
|
|
|
1515 DEFVAR_SPECIFIER ("left-toolbar",
|
|
|
1516 &Vtoolbar[LEFT_TOOLBAR] /*
|
|
|
1517 Specifier for the toolbar at the left edge of the frame.
|
|
|
1518 Use `set-specifier' to change this.
|
|
|
1519 See `default-toolbar' for a description of a valid toolbar instantiator.
|
|
|
1520
|
|
|
1521 Note that, unless the `default-toolbar-position' is `left', by
|
|
|
1522 default the height of the left toolbar (controlled by
|
|
|
1523 `left-toolbar-width') is 0; thus, a left toolbar will not be
|
|
|
1524 displayed even if you provide a value for `left-toolbar'.
|
|
|
1525 */ );
|
|
|
1526 Vtoolbar[LEFT_TOOLBAR] = Fmake_specifier (Qtoolbar);
|
|
|
1527 set_specifier_caching (Vtoolbar[LEFT_TOOLBAR],
|
|
|
1528 slot_offset (struct window,
|
|
|
1529 toolbar[LEFT_TOOLBAR]),
|
|
|
1530 toolbar_specs_changed,
|
|
|
1531 0, 0);
|
|
|
1532
|
|
|
1533 DEFVAR_SPECIFIER ("right-toolbar",
|
|
|
1534 &Vtoolbar[RIGHT_TOOLBAR] /*
|
|
|
1535 Specifier for the toolbar at the right edge of the frame.
|
|
|
1536 Use `set-specifier' to change this.
|
|
|
1537 See `default-toolbar' for a description of a valid toolbar instantiator.
|
|
|
1538
|
|
|
1539 Note that, unless the `default-toolbar-position' is `right', by
|
|
|
1540 default the height of the right toolbar (controlled by
|
|
|
1541 `right-toolbar-width') is 0; thus, a right toolbar will not be
|
|
|
1542 displayed even if you provide a value for `right-toolbar'.
|
|
|
1543 */ );
|
|
|
1544 Vtoolbar[RIGHT_TOOLBAR] = Fmake_specifier (Qtoolbar);
|
|
|
1545 set_specifier_caching (Vtoolbar[RIGHT_TOOLBAR],
|
|
|
1546 slot_offset (struct window,
|
|
|
1547 toolbar[RIGHT_TOOLBAR]),
|
|
|
1548 toolbar_specs_changed,
|
|
|
1549 0, 0);
|
|
|
1550
|
|
|
1551 /* initially, top inherits from default; this can be
|
|
|
1552 changed with `set-default-toolbar-position'. */
|
|
|
1553 elt = list1 (Fcons (Qnil, Qnil));
|
|
|
1554 set_specifier_fallback (Vdefault_toolbar, elt);
|
|
|
1555 set_specifier_fallback (Vtoolbar[TOP_TOOLBAR], Vdefault_toolbar);
|
|
|
1556 set_specifier_fallback (Vtoolbar[BOTTOM_TOOLBAR], elt);
|
|
|
1557 set_specifier_fallback (Vtoolbar[LEFT_TOOLBAR], elt);
|
|
|
1558 set_specifier_fallback (Vtoolbar[RIGHT_TOOLBAR], elt);
|
|
|
1559
|
|
|
1560 DEFVAR_SPECIFIER ("default-toolbar-height", &Vdefault_toolbar_height /*
|
|
|
1561 *Height of the default toolbar, if it's oriented horizontally.
|
|
|
1562 This is a specifier; use `set-specifier' to change it.
|
|
|
1563
|
|
|
1564 The position of the default toolbar is specified by the function
|
|
|
1565 `set-default-toolbar-position'. If the corresponding position-specific
|
|
|
1566 toolbar thickness specifier (e.g. `top-toolbar-height' if
|
|
|
1567 `default-toolbar-position' is 'top) does not specify a thickness in a
|
|
|
1568 particular domain (a window or a frame), then the value of
|
|
|
1569 `default-toolbar-height' or `default-toolbar-width' (depending on the
|
|
|
1570 toolbar orientation) in that domain, if any, will be used instead.
|
|
|
1571
|
|
|
1572 Note that `default-toolbar-height' is only used when
|
|
|
1573 `default-toolbar-position' is 'top or 'bottom, and `default-toolbar-width'
|
|
|
1574 is only used when `default-toolbar-position' is 'left or 'right.
|
|
|
1575
|
|
|
1576 Note that all of the position-specific toolbar thickness specifiers
|
|
|
1577 have a fallback value of zero when they do not correspond to the
|
|
|
1578 default toolbar. Therefore, you will have to set a non-zero thickness
|
|
|
1579 value if you want a position-specific toolbar to be displayed.
|
|
|
1580
|
|
|
1581 Internally, toolbar thickness specifiers are instantiated in both
|
|
|
1582 window and frame domains, for different purposes. The value in the
|
|
|
1583 domain of a frame's selected window specifies the actual toolbar
|
|
|
1584 thickness that you will see in that frame. The value in the domain of
|
|
|
1585 a frame itself specifies the toolbar thickness that is used in frame
|
|
|
1586 geometry calculations.
|
|
|
1587
|
|
|
1588 Thus, for example, if you set the frame width to 80 characters and the
|
|
|
1589 left toolbar width for that frame to 68 pixels, then the frame will
|
|
|
1590 be sized to fit 80 characters plus a 68-pixel left toolbar. If you
|
|
|
1591 then set the left toolbar width to 0 for a particular buffer (or if
|
|
|
1592 that buffer does not specify a left toolbar or has a nil value
|
|
|
1593 specified for `left-toolbar-visible-p'), you will find that, when
|
|
|
1594 that buffer is displayed in the selected window, the window will have
|
|
|
1595 a width of 86 or 87 characters -- the frame is sized for a 68-pixel
|
|
|
1596 left toolbar but the selected window specifies that the left toolbar
|
|
|
1597 is not visible, so it is expanded to take up the slack.
|
|
|
1598 */ );
|
|
|
1599 Vdefault_toolbar_height = Fmake_specifier (Qnatnum);
|
|
|
1600 set_specifier_caching (Vdefault_toolbar_height,
|
|
|
1601 slot_offset (struct window,
|
|
|
1602 default_toolbar_height),
|
|
|
1603 some_window_value_changed,
|
|
|
1604 slot_offset (struct frame,
|
|
|
1605 default_toolbar_height),
|
|
|
1606 default_toolbar_size_changed_in_frame);
|
|
|
1607
|
|
|
1608 DEFVAR_SPECIFIER ("default-toolbar-width", &Vdefault_toolbar_width /*
|
|
|
1609 *Width of the default toolbar, if it's oriented vertically.
|
|
|
1610 This is a specifier; use `set-specifier' to change it.
|
|
|
1611
|
|
|
1612 See `default-toolbar-height' for more information.
|
|
|
1613 */ );
|
|
|
1614 Vdefault_toolbar_width = Fmake_specifier (Qnatnum);
|
|
|
1615 set_specifier_caching (Vdefault_toolbar_width,
|
|
|
1616 slot_offset (struct window,
|
|
|
1617 default_toolbar_width),
|
|
|
1618 some_window_value_changed,
|
|
|
1619 slot_offset (struct frame,
|
|
|
1620 default_toolbar_width),
|
|
|
1621 default_toolbar_size_changed_in_frame);
|
|
|
1622
|
|
|
1623 DEFVAR_SPECIFIER ("top-toolbar-height",
|
|
|
1624 &Vtoolbar_size[TOP_TOOLBAR] /*
|
|
|
1625 *Height of the top toolbar.
|
|
|
1626 This is a specifier; use `set-specifier' to change it.
|
|
|
1627
|
|
|
1628 See `default-toolbar-height' for more information.
|
|
|
1629 */ );
|
|
|
1630 Vtoolbar_size[TOP_TOOLBAR] = Fmake_specifier (Qnatnum);
|
|
|
1631 set_specifier_caching (Vtoolbar_size[TOP_TOOLBAR],
|
|
|
1632 slot_offset (struct window,
|
|
|
1633 toolbar_size[TOP_TOOLBAR]),
|
|
|
1634 some_window_value_changed,
|
|
|
1635 slot_offset (struct frame,
|
|
|
1636 toolbar_size[TOP_TOOLBAR]),
|
|
|
1637 toolbar_size_changed_in_frame);
|
|
|
1638
|
|
|
1639 DEFVAR_SPECIFIER ("bottom-toolbar-height",
|
|
|
1640 &Vtoolbar_size[BOTTOM_TOOLBAR] /*
|
|
|
1641 *Height of the bottom toolbar.
|
|
|
1642 This is a specifier; use `set-specifier' to change it.
|
|
|
1643
|
|
|
1644 See `default-toolbar-height' for more information.
|
|
|
1645 */ );
|
|
|
1646 Vtoolbar_size[BOTTOM_TOOLBAR] = Fmake_specifier (Qnatnum);
|
|
|
1647 set_specifier_caching (Vtoolbar_size[BOTTOM_TOOLBAR],
|
|
|
1648 slot_offset (struct window,
|
|
|
1649 toolbar_size[BOTTOM_TOOLBAR]),
|
|
|
1650 some_window_value_changed,
|
|
|
1651 slot_offset (struct frame,
|
|
|
1652 toolbar_size[BOTTOM_TOOLBAR]),
|
|
|
1653 toolbar_size_changed_in_frame);
|
|
|
1654
|
|
|
1655 DEFVAR_SPECIFIER ("left-toolbar-width",
|
|
|
1656 &Vtoolbar_size[LEFT_TOOLBAR] /*
|
|
|
1657 *Width of left toolbar.
|
|
|
1658 This is a specifier; use `set-specifier' to change it.
|
|
|
1659
|
|
|
1660 See `default-toolbar-height' for more information.
|
|
|
1661 */ );
|
|
|
1662 Vtoolbar_size[LEFT_TOOLBAR] = Fmake_specifier (Qnatnum);
|
|
|
1663 set_specifier_caching (Vtoolbar_size[LEFT_TOOLBAR],
|
|
|
1664 slot_offset (struct window,
|
|
|
1665 toolbar_size[LEFT_TOOLBAR]),
|
|
|
1666 some_window_value_changed,
|
|
|
1667 slot_offset (struct frame,
|
|
|
1668 toolbar_size[LEFT_TOOLBAR]),
|
|
|
1669 toolbar_size_changed_in_frame);
|
|
|
1670
|
|
|
1671 DEFVAR_SPECIFIER ("right-toolbar-width",
|
|
|
1672 &Vtoolbar_size[RIGHT_TOOLBAR] /*
|
|
|
1673 *Width of right toolbar.
|
|
|
1674 This is a specifier; use `set-specifier' to change it.
|
|
|
1675
|
|
|
1676 See `default-toolbar-height' for more information.
|
|
|
1677 */ );
|
|
|
1678 Vtoolbar_size[RIGHT_TOOLBAR] = Fmake_specifier (Qnatnum);
|
|
|
1679 set_specifier_caching (Vtoolbar_size[RIGHT_TOOLBAR],
|
|
|
1680 slot_offset (struct window,
|
|
|
1681 toolbar_size[RIGHT_TOOLBAR]),
|
|
|
1682 some_window_value_changed,
|
|
|
1683 slot_offset (struct frame,
|
|
|
1684 toolbar_size[RIGHT_TOOLBAR]),
|
|
|
1685 toolbar_size_changed_in_frame);
|
|
|
1686
|
|
|
1687 /* #### this is ugly. */
|
|
|
1688 elt = list1 (Fcons (list1 (Qtty), Qzero));
|
|
|
1689 #ifdef HAVE_X_WINDOWS
|
|
|
1690 elt = Fcons (Fcons (list1 (Qx), make_int (DEFAULT_TOOLBAR_HEIGHT)), elt);
|
|
|
1691 #endif
|
|
|
1692 #ifdef HAVE_NEXTSTEP
|
|
|
1693 elt = Fcons (Fcons (list1 (Qns), make_int (DEFAULT_TOOLBAR_HEIGHT)), elt);
|
|
|
1694 #endif
|
|
|
1695 set_specifier_fallback (Vdefault_toolbar_height, elt);
|
|
|
1696 elt = list1 (Fcons (list1 (Qtty), Qzero));
|
|
|
1697 #ifdef HAVE_X_WINDOWS
|
|
|
1698 elt = Fcons (Fcons (list1 (Qx), make_int (DEFAULT_TOOLBAR_WIDTH)), elt);
|
|
|
1699 #endif
|
|
|
1700 #ifdef HAVE_NEXTSTEP
|
|
|
1701 elt = Fcons (Fcons (list1 (Qns), make_int (DEFAULT_TOOLBAR_WIDTH)), elt);
|
|
|
1702 #endif
|
|
|
1703 set_specifier_fallback (Vdefault_toolbar_width, elt);
|
|
|
1704
|
|
|
1705 set_specifier_fallback (Vtoolbar_size[TOP_TOOLBAR], Vdefault_toolbar_height);
|
|
|
1706 elt = list1 (Fcons (Qnil, Qzero));
|
|
|
1707 set_specifier_fallback (Vtoolbar_size[BOTTOM_TOOLBAR], elt);
|
|
|
1708 set_specifier_fallback (Vtoolbar_size[LEFT_TOOLBAR], elt);
|
|
|
1709 set_specifier_fallback (Vtoolbar_size[RIGHT_TOOLBAR], elt);
|
|
|
1710
|
|
|
1711 DEFVAR_SPECIFIER ("default-toolbar-visible-p", &Vdefault_toolbar_visible_p /*
|
|
|
1712 *Whether the default toolbar is visible.
|
|
|
1713 This is a specifier; use `set-specifier' to change it.
|
|
|
1714
|
|
|
1715 The position of the default toolbar is specified by the function
|
|
|
1716 `set-default-toolbar-position'. If the corresponding position-specific
|
|
|
1717 toolbar visibility specifier (e.g. `top-toolbar-visible-p' if
|
|
|
1718 `default-toolbar-position' is 'top) does not specify a visible-p value
|
|
|
1719 in a particular domain (a window or a frame), then the value of
|
|
|
1720 `default-toolbar-visible-p' in that domain, if any, will be used
|
|
|
1721 instead.
|
|
|
1722
|
|
|
1723 Both window domains and frame domains are used internally, for
|
|
|
1724 different purposes. The distinction here is exactly the same as
|
|
|
1725 for thickness specifiers; see `default-toolbar-height' for more
|
|
|
1726 information.
|
|
|
1727
|
|
|
1728 `default-toolbar-visible-p' and all of the position-specific toolbar
|
|
|
1729 visibility specifiers have a fallback value of true.
|
|
|
1730 */ );
|
|
|
1731 Vdefault_toolbar_visible_p = Fmake_specifier (Qboolean);
|
|
|
1732 set_specifier_caching (Vdefault_toolbar_visible_p,
|
|
|
1733 slot_offset (struct window,
|
|
|
1734 default_toolbar_visible_p),
|
|
|
1735 some_window_value_changed,
|
|
|
1736 slot_offset (struct frame,
|
|
|
1737 default_toolbar_visible_p),
|
|
|
1738 default_toolbar_visible_p_changed_in_frame);
|
|
|
1739
|
|
|
1740 DEFVAR_SPECIFIER ("top-toolbar-visible-p",
|
|
|
1741 &Vtoolbar_visible_p[TOP_TOOLBAR] /*
|
|
|
1742 *Whether the top toolbar is visible.
|
|
|
1743 This is a specifier; use `set-specifier' to change it.
|
|
|
1744
|
|
|
1745 See `default-toolbar-visible-p' for more information.
|
|
|
1746 */ );
|
|
|
1747 Vtoolbar_visible_p[TOP_TOOLBAR] = Fmake_specifier (Qboolean);
|
|
|
1748 set_specifier_caching (Vtoolbar_visible_p[TOP_TOOLBAR],
|
|
|
1749 slot_offset (struct window,
|
|
|
1750 toolbar_visible_p[TOP_TOOLBAR]),
|
|
|
1751 some_window_value_changed,
|
|
|
1752 slot_offset (struct frame,
|
|
|
1753 toolbar_visible_p[TOP_TOOLBAR]),
|
|
|
1754 toolbar_visible_p_changed_in_frame);
|
|
|
1755
|
|
|
1756 DEFVAR_SPECIFIER ("bottom-toolbar-visible-p",
|
|
|
1757 &Vtoolbar_visible_p[BOTTOM_TOOLBAR] /*
|
|
|
1758 *Whether the bottom toolbar is visible.
|
|
|
1759 This is a specifier; use `set-specifier' to change it.
|
|
|
1760
|
|
|
1761 See `default-toolbar-visible-p' for more information.
|
|
|
1762 */ );
|
|
|
1763 Vtoolbar_visible_p[BOTTOM_TOOLBAR] = Fmake_specifier (Qboolean);
|
|
|
1764 set_specifier_caching (Vtoolbar_visible_p[BOTTOM_TOOLBAR],
|
|
|
1765 slot_offset (struct window,
|
|
|
1766 toolbar_visible_p[BOTTOM_TOOLBAR]),
|
|
|
1767 some_window_value_changed,
|
|
|
1768 slot_offset (struct frame,
|
|
|
1769 toolbar_visible_p[BOTTOM_TOOLBAR]),
|
|
|
1770 toolbar_visible_p_changed_in_frame);
|
|
|
1771
|
|
|
1772 DEFVAR_SPECIFIER ("left-toolbar-visible-p",
|
|
|
1773 &Vtoolbar_visible_p[LEFT_TOOLBAR] /*
|
|
|
1774 *Whether the left toolbar is visible.
|
|
|
1775 This is a specifier; use `set-specifier' to change it.
|
|
|
1776
|
|
|
1777 See `default-toolbar-visible-p' for more information.
|
|
|
1778 */ );
|
|
|
1779 Vtoolbar_visible_p[LEFT_TOOLBAR] = Fmake_specifier (Qboolean);
|
|
|
1780 set_specifier_caching (Vtoolbar_visible_p[LEFT_TOOLBAR],
|
|
|
1781 slot_offset (struct window,
|
|
|
1782 toolbar_visible_p[LEFT_TOOLBAR]),
|
|
|
1783 some_window_value_changed,
|
|
|
1784 slot_offset (struct frame,
|
|
|
1785 toolbar_visible_p[LEFT_TOOLBAR]),
|
|
|
1786 toolbar_visible_p_changed_in_frame);
|
|
|
1787
|
|
|
1788 DEFVAR_SPECIFIER ("right-toolbar-visible-p",
|
|
|
1789 &Vtoolbar_visible_p[RIGHT_TOOLBAR] /*
|
|
|
1790 *Whether the right toolbar is visible.
|
|
|
1791 This is a specifier; use `set-specifier' to change it.
|
|
|
1792
|
|
|
1793 See `default-toolbar-visible-p' for more information.
|
|
|
1794 */ );
|
|
|
1795 Vtoolbar_visible_p[RIGHT_TOOLBAR] = Fmake_specifier (Qboolean);
|
|
|
1796 set_specifier_caching (Vtoolbar_visible_p[RIGHT_TOOLBAR],
|
|
|
1797 slot_offset (struct window,
|
|
|
1798 toolbar_visible_p[RIGHT_TOOLBAR]),
|
|
|
1799 some_window_value_changed,
|
|
|
1800 slot_offset (struct frame,
|
|
|
1801 toolbar_visible_p[RIGHT_TOOLBAR]),
|
|
|
1802 toolbar_visible_p_changed_in_frame);
|
|
|
1803
|
|
|
1804 /* initially, top inherits from default; this can be
|
|
|
1805 changed with `set-default-toolbar-position'. */
|
|
|
1806 elt = list1 (Fcons (Qnil, Qt));
|
|
|
1807 set_specifier_fallback (Vdefault_toolbar_visible_p, elt);
|
|
|
1808 set_specifier_fallback (Vtoolbar_visible_p[TOP_TOOLBAR],
|
|
|
1809 Vdefault_toolbar_visible_p);
|
|
|
1810 set_specifier_fallback (Vtoolbar_visible_p[BOTTOM_TOOLBAR], elt);
|
|
|
1811 set_specifier_fallback (Vtoolbar_visible_p[LEFT_TOOLBAR], elt);
|
|
|
1812 set_specifier_fallback (Vtoolbar_visible_p[RIGHT_TOOLBAR], elt);
|
|
|
1813
|
|
|
1814 DEFVAR_SPECIFIER ("toolbar-buttons-captioned-p",
|
|
|
1815 &Vtoolbar_buttons_captioned_p /*
|
|
|
1816 *Whether the toolbar buttons are captioned.
|
|
|
1817 This will only have a visible effect for those toolbar buttons which had
|
|
|
1818 captioned versions specified.
|
|
|
1819 This is a specifier; use `set-specifier' to change it.
|
|
|
1820 */ );
|
|
|
1821 Vtoolbar_buttons_captioned_p = Fmake_specifier (Qboolean);
|
|
|
1822 set_specifier_caching (Vtoolbar_buttons_captioned_p,
|
|
|
1823 slot_offset (struct window,
|
|
|
1824 toolbar_buttons_captioned_p),
|
|
|
1825 toolbar_buttons_captioned_p_changed,
|
|
|
1826 0, 0);
|
|
|
1827 set_specifier_fallback (Vtoolbar_buttons_captioned_p,
|
|
|
1828 list1 (Fcons (Qnil, Qt)));
|
|
|
1829 }
|
