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