1 /* Generic frame functions.
2 Copyright (C) 1989, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
3 Copyright (C) 1995, 1996 Ben Wing.
4 Copyright (C) 1995 Sun Microsystems, Inc.
6 This file is part of XEmacs.
8 XEmacs is free software; you can redistribute it and/or modify it
9 under the terms of the GNU General Public License as published by the
10 Free Software Foundation; either version 2, or (at your option) any
13 XEmacs is distributed in the hope that it will be useful, but WITHOUT
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License
19 along with XEmacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
23 /* Synched up with: FSF 19.30. */
25 /* This file has been Mule-ized. */
30 #include "buffer.h" /* for Vbuffer_alist */
39 #include "redisplay.h"
40 #include "scrollbar.h"
43 Lisp_Object Vselect_frame_hook, Qselect_frame_hook;
44 Lisp_Object Vdeselect_frame_hook, Qdeselect_frame_hook;
45 Lisp_Object Vcreate_frame_hook, Qcreate_frame_hook;
46 Lisp_Object Vdelete_frame_hook, Qdelete_frame_hook;
47 Lisp_Object Vmouse_enter_frame_hook, Qmouse_enter_frame_hook;
48 Lisp_Object Vmouse_leave_frame_hook, Qmouse_leave_frame_hook;
49 Lisp_Object Vmap_frame_hook, Qmap_frame_hook;
50 Lisp_Object Vunmap_frame_hook, Qunmap_frame_hook;
51 int allow_deletion_of_last_visible_frame;
52 Lisp_Object Vadjust_frame_function;
53 Lisp_Object Vmouse_motion_handler;
54 Lisp_Object Vsynchronize_minibuffers;
55 Lisp_Object Qsynchronize_minibuffers;
56 Lisp_Object Qbuffer_predicate;
57 Lisp_Object Qmake_initial_minibuffer_frame;
58 Lisp_Object Qcustom_initialize_frame;
60 /* We declare all these frame properties here even though many of them
61 are currently only used in frame-x.c, because we should generalize
64 Lisp_Object Qminibuffer;
65 Lisp_Object Qunsplittable;
66 Lisp_Object Qinternal_border_width;
67 Lisp_Object Qtop_toolbar_shadow_color;
68 Lisp_Object Qbottom_toolbar_shadow_color;
69 Lisp_Object Qbackground_toolbar_color;
70 Lisp_Object Qtop_toolbar_shadow_pixmap;
71 Lisp_Object Qbottom_toolbar_shadow_pixmap;
72 Lisp_Object Qtoolbar_shadow_thickness;
73 Lisp_Object Qscrollbar_placement;
74 Lisp_Object Qinter_line_space;
75 Lisp_Object Qvisual_bell;
76 Lisp_Object Qbell_volume;
77 Lisp_Object Qpointer_background;
78 Lisp_Object Qpointer_color;
79 Lisp_Object Qtext_pointer;
80 Lisp_Object Qspace_pointer;
81 Lisp_Object Qmodeline_pointer;
82 Lisp_Object Qgc_pointer;
83 Lisp_Object Qinitially_unmapped;
84 Lisp_Object Quse_backing_store;
85 Lisp_Object Qborder_color;
86 Lisp_Object Qborder_width;
88 Lisp_Object Qframep, Qframe_live_p;
89 Lisp_Object Qdelete_frame;
91 Lisp_Object Qframe_title_format, Vframe_title_format;
92 Lisp_Object Qframe_icon_title_format, Vframe_icon_title_format;
94 Lisp_Object Vdefault_frame_name;
95 Lisp_Object Vdefault_frame_plist;
97 Lisp_Object Vframe_icon_glyph;
101 Lisp_Object Qvisible, Qiconic, Qinvisible, Qvisible_iconic, Qinvisible_iconic;
102 Lisp_Object Qnomini, Qvisible_nomini, Qiconic_nomini, Qinvisible_nomini;
103 Lisp_Object Qvisible_iconic_nomini, Qinvisible_iconic_nomini;
105 Lisp_Object Qset_specifier, Qset_glyph_image, Qset_face_property;
106 Lisp_Object Qface_property_instance;
108 Lisp_Object Qframe_property_alias;
110 /* If this is non-nil, it is the frame that make-frame is currently
111 creating. We can't set the current frame to this in case the
112 debugger goes off because it would try and display to it. However,
113 there are some places which need to reference it which have no
114 other way of getting it if it isn't the selected frame. */
115 Lisp_Object Vframe_being_created;
116 Lisp_Object Qframe_being_created;
118 static void store_minibuf_frame_prop (struct frame *f, Lisp_Object val);
119 static struct display_line title_string_display_line;
120 /* Used by generate_title_string. Global because they get used so much that
121 the dynamic allocation time adds up. */
122 static Emchar_dynarr *title_string_emchar_dynarr;
124 EXFUN (Fset_frame_properties, 2);
128 mark_frame (Lisp_Object obj)
130 struct frame *f = XFRAME (obj);
132 #define MARKED_SLOT(x) mark_object (f->x)
133 #include "frameslots.h"
135 mark_subwindow_cachels (f->subwindow_cachels);
137 if (FRAME_LIVE_P (f)) /* device is nil for a dead frame */
138 MAYBE_FRAMEMETH (f, mark_frame, (f));
144 print_frame (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag)
146 struct frame *frm = XFRAME (obj);
150 error ("printing unreadable object #<frame %s 0x%x>",
151 XSTRING_DATA (frm->name), frm->header.uid);
153 sprintf (buf, "#<%s-frame ", !FRAME_LIVE_P (frm) ? "dead" :
154 FRAME_TYPE_NAME (frm));
155 write_c_string (buf, printcharfun);
156 print_internal (frm->name, printcharfun, 1);
157 sprintf (buf, " 0x%x>", frm->header.uid);
158 write_c_string (buf, printcharfun);
161 DEFINE_LRECORD_IMPLEMENTATION ("frame", frame,
162 mark_frame, print_frame, 0, 0, 0, 0,
166 nuke_all_frame_slots (struct frame *f)
168 #define MARKED_SLOT(x) f->x = Qnil
169 #include "frameslots.h"
172 /* Allocate a new frame object and set all its fields to reasonable
173 values. The root window is created but the minibuffer will be done
176 static struct frame *
177 allocate_frame_core (Lisp_Object device)
179 /* This function can GC */
181 Lisp_Object root_window;
182 struct frame *f = alloc_lcrecord_type (struct frame, &lrecord_frame);
185 nuke_all_frame_slots (f);
186 XSETFRAME (frame, f);
189 f->framemeths = XDEVICE (device)->devmeths;
190 f->buffer_alist = Fcopy_sequence (Vbuffer_alist);
192 root_window = allocate_window ();
193 XWINDOW (root_window)->frame = frame;
196 Just so that there is "something there."
197 Correct size will be set up later with change_frame_size. */
202 XWINDOW (root_window)->pixel_width = 10;
203 XWINDOW (root_window)->pixel_height = 9;
205 /* The size of the minibuffer window is now set in x_create_frame
208 f->root_window = root_window;
209 f->selected_window = root_window;
210 f->last_nonminibuf_window = root_window;
212 /* cache of subwindows visible on frame */
213 f->subwindow_cachels = Dynarr_new (subwindow_cachel);
215 /* associated exposure ignore list */
216 f->subwindow_exposures = 0;
217 f->subwindow_exposures_tail = 0;
219 /* Choose a buffer for the frame's root window. */
220 XWINDOW (root_window)->buffer = Qt;
224 buf = Fcurrent_buffer ();
225 /* If buf is a 'hidden' buffer (i.e. one whose name starts with
226 a space), try to find another one. */
227 if (string_char (XSTRING (Fbuffer_name (buf)), 0) == ' ')
228 buf = Fother_buffer (buf, Qnil, Qnil);
229 Fset_window_buffer (root_window, buf, Qnil);
236 setup_normal_frame (struct frame *f)
238 Lisp_Object mini_window;
241 XSETFRAME (frame, f);
243 mini_window = allocate_window ();
244 XWINDOW (f->root_window)->next = mini_window;
245 XWINDOW (mini_window)->prev = f->root_window;
246 XWINDOW (mini_window)->mini_p = Qt;
247 XWINDOW (mini_window)->frame = frame;
248 f->minibuffer_window = mini_window;
249 f->has_minibuffer = 1;
251 XWINDOW (mini_window)->buffer = Qt;
252 Fset_window_buffer (mini_window, Vminibuffer_zero, Qt);
255 /* Make a frame using a separate minibuffer window on another frame.
256 MINI_WINDOW is the minibuffer window to use. nil means use the
257 default-minibuffer-frame. */
260 setup_frame_without_minibuffer (struct frame *f, Lisp_Object mini_window)
262 /* This function can GC */
263 Lisp_Object device = f->device;
265 if (!NILP (mini_window))
266 CHECK_LIVE_WINDOW (mini_window);
268 if (!NILP (mini_window)
269 && !EQ (DEVICE_CONSOLE (XDEVICE (device)),
270 FRAME_CONSOLE (XFRAME (XWINDOW (mini_window)->frame))))
271 error ("frame and minibuffer must be on the same console");
273 if (NILP (mini_window))
275 struct console *con = XCONSOLE (FRAME_CONSOLE (f));
276 /* Use default-minibuffer-frame if possible. */
277 if (!FRAMEP (con->default_minibuffer_frame)
278 || ! FRAME_LIVE_P (XFRAME (con->default_minibuffer_frame)))
280 /* If there's no minibuffer frame to use, create one. */
281 con->default_minibuffer_frame
282 = call1 (Qmake_initial_minibuffer_frame, device);
284 mini_window = XFRAME (con->default_minibuffer_frame)->minibuffer_window;
287 /* Install the chosen minibuffer window, with proper buffer. */
288 store_minibuf_frame_prop (f, mini_window);
289 Fset_window_buffer (mini_window, Vminibuffer_zero, Qt);
292 /* Make a frame containing only a minibuffer window. */
295 setup_minibuffer_frame (struct frame *f)
297 /* This function can GC */
298 /* First make a frame containing just a root window, no minibuffer. */
299 Lisp_Object mini_window;
302 XSETFRAME (frame, f);
305 f->has_minibuffer = 1;
307 /* Now label the root window as also being the minibuffer.
308 Avoid infinite looping on the window chain by marking next pointer
311 mini_window = f->minibuffer_window = f->root_window;
312 XWINDOW (mini_window)->mini_p = Qt;
313 XWINDOW (mini_window)->next = Qnil;
314 XWINDOW (mini_window)->prev = Qnil;
315 XWINDOW (mini_window)->frame = frame;
317 /* Put the proper buffer in that window. */
319 Fset_window_buffer (mini_window, Vminibuffer_zero, Qt);
323 make_sure_its_a_fresh_plist (Lisp_Object foolist)
325 if (CONSP (Fcar (foolist)))
327 /* looks like an alist to me. */
328 foolist = Fcopy_alist (foolist);
329 foolist = Fdestructive_alist_to_plist (foolist);
332 foolist = Fcopy_sequence (foolist);
337 DEFUN ("make-frame", Fmake_frame, 0, 2, "", /*
338 Create and return a new frame, displaying the current buffer.
339 Runs the functions listed in `create-frame-hook' after frame creation.
341 Optional argument PROPS is a property list (a list of alternating
342 keyword-value specifications) of properties for the new frame.
343 \(An alist is accepted for backward compatibility but should not
346 See `set-frame-properties', `default-x-frame-plist', and
347 `default-tty-frame-plist' for the specially-recognized properties.
353 Lisp_Object frame = Qnil, name = Qnil, minibuf;
354 struct gcpro gcpro1, gcpro2, gcpro3;
355 int speccount = specpdl_depth ();
356 int first_frame_on_device = 0;
357 int first_frame_on_console = 0;
359 d = decode_device (device);
360 XSETDEVICE (device, d);
362 /* PROPS and NAME may be freshly-created, so make sure to GCPRO. */
363 GCPRO3 (frame, props, name);
365 props = make_sure_its_a_fresh_plist (props);
366 if (DEVICE_SPECIFIC_FRAME_PROPS (d))
367 /* Put the device-specific props before the more general ones so
368 that they override them. */
369 props = nconc2 (props,
370 make_sure_its_a_fresh_plist
371 (*DEVICE_SPECIFIC_FRAME_PROPS (d)));
372 props = nconc2 (props, make_sure_its_a_fresh_plist (Vdefault_frame_plist));
373 Fcanonicalize_lax_plist (props, Qnil);
375 name = Flax_plist_get (props, Qname, Qnil);
378 else if (STRINGP (Vdefault_frame_name))
379 name = Vdefault_frame_name;
381 name = build_string ("emacs");
383 if (!NILP (Fstring_match (make_string ((CONST Bufbyte *) "\\.", 2), name,
385 signal_simple_error (". not allowed in frame names", name);
387 f = allocate_frame_core (device);
388 XSETFRAME (frame, f);
390 specbind (Qframe_being_created, name);
393 FRAMEMETH (f, init_frame_1, (f, props));
395 minibuf = Flax_plist_get (props, Qminibuffer, Qunbound);
396 if (UNBOUNDP (minibuf))
398 /* If minibuf is unspecified, then look for a minibuffer X resource. */
399 /* #### Not implemented any more. We need to fix things up so
400 that we search out all X resources and append them to the end of
401 props, above. This is the only way in general to assure
402 coherent behavior for all frame properties/resources/etc. */
405 props = Flax_plist_remprop (props, Qminibuffer);
407 if (EQ (minibuf, Qnone) || NILP (minibuf))
408 setup_frame_without_minibuffer (f, Qnil);
409 else if (EQ (minibuf, Qonly))
410 setup_minibuffer_frame (f);
411 else if (WINDOWP (minibuf))
412 setup_frame_without_minibuffer (f, minibuf);
413 else if (EQ (minibuf, Qt) || UNBOUNDP (minibuf))
414 setup_normal_frame (f);
416 signal_simple_error ("Invalid value for `minibuffer'", minibuf);
418 update_frame_window_mirror (f);
420 if (initialized && !DEVICE_STREAM_P (d))
422 if (!NILP (f->minibuffer_window))
423 reset_face_cachels (XWINDOW (f->minibuffer_window));
424 reset_face_cachels (XWINDOW (f->root_window));
427 /* If no frames on this device formerly existed, say this is the
428 first frame. It kind of assumes that frameless devices don't
429 exist, but it shouldn't be too harmful. */
430 if (NILP (DEVICE_FRAME_LIST (d)))
431 first_frame_on_device = 1;
433 /* This *must* go before the init_*() methods. Those functions
434 call Lisp code, and if any of them causes a warning to be displayed
435 and the *Warnings* buffer to be created, it won't get added to
436 the frame-specific version of the buffer-alist unless the frame
437 is accessible from the device. */
440 DEVICE_FRAME_LIST (d) = nconc2 (DEVICE_FRAME_LIST (d), Fcons (frame, Qnil));
442 DEVICE_FRAME_LIST (d) = Fcons (frame, DEVICE_FRAME_LIST (d));
443 RESET_CHANGED_SET_FLAGS;
445 /* Now make sure that the initial cached values are set correctly.
446 Do this after the init_frame method is called because that may
447 do things (e.g. create widgets) that are necessary for the
448 specifier value-changed methods to work OK. */
449 recompute_all_cached_specifiers_in_frame (f);
451 if (!DEVICE_STREAM_P (d))
453 init_frame_faces (f);
455 #ifdef HAVE_SCROLLBARS
456 /* Finish up resourcing the scrollbars. */
457 init_frame_scrollbars (f);
461 /* Create the initial toolbars. We have to do this after the frame
462 methods are called because it may potentially call some things itself
463 which depend on the normal frame methods having initialized
465 init_frame_toolbars (f);
467 reset_face_cachels (XWINDOW (FRAME_SELECTED_WINDOW (f)));
468 reset_glyph_cachels (XWINDOW (FRAME_SELECTED_WINDOW (f)));
469 reset_subwindow_cachels (f);
470 change_frame_size (f, f->height, f->width, 0);
474 MAYBE_FRAMEMETH (f, init_frame_2, (f, props));
475 Fset_frame_properties (frame, props);
476 MAYBE_FRAMEMETH (f, init_frame_3, (f));
478 /* now initialise the gutters, this won't change the frame size
480 if (!DEVICE_STREAM_P (d))
481 init_frame_gutters (f);
483 /* Hallelujah, praise the lord. */
484 f->init_finished = 1;
486 /* If this is the first frame on the device, make it the selected one. */
487 if (first_frame_on_device && NILP (DEVICE_SELECTED_FRAME (d)))
488 set_device_selected_frame (d, frame);
490 /* If at startup or if the current console is a stream console
491 (usually also at startup), make this console the selected one
492 so that messages show up on it. */
493 if (NILP (Fselected_console ()) ||
494 CONSOLE_STREAM_P (XCONSOLE (Fselected_console ())))
495 Fselect_console (DEVICE_CONSOLE (d));
497 first_frame_on_console =
498 (first_frame_on_device &&
499 XINT (Flength (CONSOLE_DEVICE_LIST (XCONSOLE (DEVICE_CONSOLE (d)))))
502 /* #### all this calling of frame methods at various odd times
503 is somewhat of a mess. It's necessary to do it this way due
504 to strange console-type-specific things that need to be done. */
505 MAYBE_FRAMEMETH (f, after_init_frame, (f, first_frame_on_device,
506 first_frame_on_console));
508 if (first_frame_on_device)
510 if (first_frame_on_console)
511 va_run_hook_with_args (Qcreate_console_hook, 1, DEVICE_CONSOLE (d));
512 va_run_hook_with_args (Qcreate_device_hook, 1, device);
514 va_run_hook_with_args (Qcreate_frame_hook, 1, frame);
516 /* Initialize custom-specific stuff. */
517 if (!UNBOUNDP (symbol_function (XSYMBOL (Qcustom_initialize_frame))))
518 call1 (Qcustom_initialize_frame, frame);
520 unbind_to (speccount, Qnil);
527 /* this function should be used in most cases when a Lisp function is passed
528 a FRAME argument. Use this unless you don't accept nil == current frame
529 (in which case, do a CHECK_LIVE_FRAME() and then an XFRAME()) or you
530 allow dead frames. Note that very few functions should accept dead
531 frames. It could be argued that functions should just do nothing when
532 given a dead frame, but the presence of a dead frame usually indicates
533 an oversight in the Lisp code that could potentially lead to strange
534 results and so it is better to catch the error early.
536 If you only accept X frames, use decode_x_frame(), which does what this
537 function does but also makes sure the frame is an X frame. */
540 decode_frame (Lisp_Object frame)
543 return selected_frame ();
545 CHECK_LIVE_FRAME (frame);
546 return XFRAME (frame);
550 decode_frame_or_selected (Lisp_Object cdf)
553 cdf = CONSOLE_SELECTED_DEVICE (decode_console (cdf));
555 cdf = DEVICE_SELECTED_FRAME (decode_device (cdf));
556 return decode_frame (cdf);
560 make_frame (struct frame *f)
563 XSETFRAME (frame, f);
569 * window size changes are held up during critical regions. Afterwards,
570 * we want to deal with any delayed changes.
573 hold_frame_size_changes (void)
579 unhold_one_frame_size_changes (struct frame *f)
583 if (f->size_change_pending)
584 change_frame_size (f, f->new_height, f->new_width, 0);
588 unhold_frame_size_changes (void)
590 Lisp_Object frmcons, devcons, concons;
592 FRAME_LOOP_NO_BREAK (frmcons, devcons, concons)
593 unhold_one_frame_size_changes (XFRAME (XCAR (frmcons)));
597 invalidate_vertical_divider_cache_in_frame (struct frame *f)
599 /* Invalidate cached value of needs_vertical_divider_p in
600 every and all windows */
601 map_windows (f, invalidate_vertical_divider_cache_in_window, 0);
605 * Frame size may change due to changes in scrollbars, toolbars,
606 * default font etc. These changes are applied early in redisplay
610 adjust_frame_size (struct frame *f)
612 int keep_char_size = 0;
614 XSETFRAME (frame, f);
616 if (!f->size_slipped)
619 /* Don't adjust tty frames. #### May break when TTY have menubars.
620 Then, write an Vadjust_frame_function which will return t for TTY
621 frames. Another solution is frame_size_fixed_p method for TTYs,
622 which always returned yes it's fixed.
624 if (!FRAME_WIN_P (f))
626 CLEAR_FRAME_SIZE_SLIPPED (f);
630 /* frame_size_fixed_p tells that frame size cannot currently
631 be changed change due to external conditions */
632 if (!FRAMEMETH_OR_GIVEN (f, frame_size_fixed_p, (f), 0))
634 if (NILP (Vadjust_frame_function))
636 else if (EQ (Vadjust_frame_function, Qt))
640 NILP (call1_trapping_errors ("Error in adjust-frame-function",
641 Vadjust_frame_function, frame));
644 Fset_frame_size (frame, make_int (FRAME_CHARWIDTH(f)),
645 make_int (FRAME_CHARHEIGHT(f)), Qnil);
651 pixel_to_char_size (f, FRAME_PIXWIDTH(f), FRAME_PIXHEIGHT(f),
653 change_frame_size (f, height, width, 0);
654 CLEAR_FRAME_SIZE_SLIPPED (f);
659 * This is a "specifier changed in frame" handler for various specifiers
660 * changing which causes frame size adjustment
663 frame_size_slipped (Lisp_Object specifier, struct frame *f,
666 MARK_FRAME_SIZE_SLIPPED(f);
669 DEFUN ("framep", Fframep, 1, 1, 0, /*
670 Return non-nil if OBJECT is a frame.
671 Also see `frame-live-p'.
672 Note that FSF Emacs kludgily returns a value indicating what type of
673 frame this is. Use the cleaner function `frame-type' for that.
677 return FRAMEP (object) ? Qt : Qnil;
680 DEFUN ("frame-live-p", Fframe_live_p, 1, 1, 0, /*
681 Return non-nil if OBJECT is a frame which has not been deleted.
685 return FRAMEP (object) && FRAME_LIVE_P (XFRAME (object)) ? Qt : Qnil;
689 DEFUN ("focus-frame", Ffocus_frame, 1, 1, 0, /*
690 Select FRAME and give it the window system focus.
691 This function is not affected by the value of `focus-follows-mouse'.
695 CHECK_LIVE_FRAME (frame);
697 MAYBE_DEVMETH (XDEVICE (FRAME_DEVICE (XFRAME (frame))), focus_on_frame,
699 /* FRAME will be selected by the time we receive the next event.
700 However, it is better to select it explicitly now, in case the
701 Lisp code depends on frame being selected. */
702 Fselect_frame (frame);
706 /* Called from Fselect_window() */
708 select_frame_1 (Lisp_Object frame)
710 struct frame *f = XFRAME (frame);
711 Lisp_Object old_selected_frame = Fselected_frame (Qnil);
713 if (EQ (frame, old_selected_frame))
716 /* now select the frame's device */
717 set_device_selected_frame (XDEVICE (FRAME_DEVICE (f)), frame);
718 select_device_1 (FRAME_DEVICE (f));
720 update_frame_window_mirror (f);
723 DEFUN ("select-frame", Fselect_frame, 1, 1, 0, /*
724 Select the frame FRAME.
725 Subsequent editing commands apply to its selected window.
726 The selection of FRAME lasts until the next time the user does
727 something to select a different frame, or until the next time this
730 Note that this does not actually cause the window-system focus to be
731 set to this frame, or the `select-frame-hook' or `deselect-frame-hook'
732 to be run, until the next time that XEmacs is waiting for an event.
734 Also note that when focus-follows-mouse is non-nil, the frame
735 selection is temporary and is reverted when the current command
736 terminates, much like the buffer selected by `set-buffer'. In order
737 to effect a permanent focus change, use `focus-frame'.
741 CHECK_LIVE_FRAME (frame);
743 /* select the frame's selected window. This will call
744 selected_frame_1(). */
745 Fselect_window (FRAME_SELECTED_WINDOW (XFRAME (frame)), Qnil);
747 /* Nothing should be depending on the return value of this function.
748 But, of course, there is stuff out there which is. */
752 /* use this to retrieve the currently selected frame. You should use
753 this in preference to Fselected_frame (Qnil) unless you are prepared
754 to handle the possibility of there being no selected frame (this
755 happens at some points during startup). */
758 selected_frame (void)
760 Lisp_Object device = Fselected_device (Qnil);
761 Lisp_Object frame = DEVICE_SELECTED_FRAME (XDEVICE (device));
763 signal_simple_error ("No frames exist on device", device);
764 return XFRAME (frame);
767 /* use this instead of XFRAME (DEVICE_SELECTED_FRAME (d)) to catch
768 the possibility of there being no frames on the device (just created).
769 There is no point doing this inside of redisplay because errors
770 cause an abort(), indicating a flaw in the logic, and error_check_frame()
771 will catch this just as well. */
774 device_selected_frame (struct device *d)
776 Lisp_Object frame = DEVICE_SELECTED_FRAME (d);
780 XSETDEVICE (device, d);
781 signal_simple_error ("No frames exist on device", device);
783 return XFRAME (frame);
788 xxDEFUN ("handle-switch-frame", Fhandle_switch_frame, 1, 2, "e", /*
789 Handle a switch-frame event EVENT.
790 Switch-frame events are usually bound to this function.
791 A switch-frame event tells Emacs that the window manager has requested
792 that the user's events be directed to the frame mentioned in the event.
793 This function selects the selected window of the frame of EVENT.
795 If EVENT is frame object, handle it as if it were a switch-frame event
800 /* Preserve prefix arg that the command loop just cleared. */
801 XCONSOLE (Vselected_console)->prefix_arg = Vcurrent_prefix_arg;
803 run_hook (Qmouse_leave_buffer_hook);
805 return do_switch_frame (frame, no_enter, 0);
808 /* A load of garbage. */
809 xxDEFUN ("ignore-event", Fignore_event, 0, 0, "", /*
810 Do nothing, but preserve any prefix argument already specified.
811 This is a suitable binding for iconify-frame and make-frame-visible.
815 struct console *c = XCONSOLE (Vselected_console);
817 c->prefix_arg = Vcurrent_prefix_arg;
823 DEFUN ("selected-frame", Fselected_frame, 0, 1, 0, /*
824 Return the frame that is now selected on device DEVICE.
825 If DEVICE is not specified, the selected device will be used.
826 If no frames exist on the device, nil is returned.
830 if (NILP (device) && NILP (Fselected_device (Qnil)))
831 return Qnil; /* happens early in temacs */
832 return DEVICE_SELECTED_FRAME (decode_device (device));
836 frame_first_window (struct frame *f)
838 Lisp_Object w = f->root_window;
842 if (! NILP (XWINDOW (w)->hchild))
843 w = XWINDOW (w)->hchild;
844 else if (! NILP (XWINDOW (w)->vchild))
845 w = XWINDOW (w)->vchild;
853 DEFUN ("active-minibuffer-window", Factive_minibuffer_window, 0, 0, 0, /*
854 Return the currently active minibuffer window, or nil if none.
858 return minibuf_level ? minibuf_window : Qnil;
861 DEFUN ("last-nonminibuf-frame", Flast_nonminibuf_frame, 0, 1, 0, /*
862 Return the most-recently-selected non-minibuffer-only frame on CONSOLE.
863 This will always be the same as (selected-frame device) unless the
864 selected frame is a minibuffer-only frame.
865 CONSOLE defaults to the selected console if omitted.
871 XSETCONSOLE (console, decode_console (console));
872 /* Just in case the machinations in delete_frame_internal() resulted
873 in the last-nonminibuf-frame getting out of sync, make sure and
874 return the selected frame if it's acceptable. */
875 result = Fselected_frame (CONSOLE_SELECTED_DEVICE (XCONSOLE (console)));
876 if (!NILP (result) && !FRAME_MINIBUF_ONLY_P (XFRAME (result)))
878 return CONSOLE_LAST_NONMINIBUF_FRAME (XCONSOLE (console));
881 DEFUN ("frame-root-window", Fframe_root_window, 0, 1, 0, /*
882 Return the root-window of FRAME.
883 If omitted, FRAME defaults to the currently selected frame.
887 struct frame *f = decode_frame (frame);
888 return FRAME_ROOT_WINDOW (f);
891 DEFUN ("frame-selected-window", Fframe_selected_window, 0, 1, 0, /*
892 Return the selected window of frame object FRAME.
893 If omitted, FRAME defaults to the currently selected frame.
897 struct frame *f = decode_frame (frame);
898 return FRAME_SELECTED_WINDOW (f);
902 set_frame_selected_window (struct frame *f, Lisp_Object window)
904 assert (XFRAME (WINDOW_FRAME (XWINDOW (window))) == f);
905 f->selected_window = window;
906 if (!MINI_WINDOW_P (XWINDOW (window)) || FRAME_MINIBUF_ONLY_P (f))
909 if (!EQ (f->last_nonminibuf_window, window))
911 MARK_TOOLBAR_CHANGED;
915 f->last_nonminibuf_window = window;
919 DEFUN ("set-frame-selected-window", Fset_frame_selected_window, 2, 2, 0, /*
920 Set the selected window of frame object FRAME to WINDOW.
921 If FRAME is nil, the selected frame is used.
922 If FRAME is the selected frame, this makes WINDOW the selected window.
926 XSETFRAME (frame, decode_frame (frame));
927 CHECK_LIVE_WINDOW (window);
929 if (! EQ (frame, WINDOW_FRAME (XWINDOW (window))))
930 error ("In `set-frame-selected-window', WINDOW is not on FRAME");
932 if (XFRAME (frame) == selected_frame ())
933 return Fselect_window (window, Qnil);
935 set_frame_selected_window (XFRAME (frame), window);
940 DEFUN ("frame-device", Fframe_device, 0, 1, 0, /*
941 Return the device that FRAME is on.
942 If omitted, FRAME defaults to the currently selected frame.
946 return FRAME_DEVICE (decode_frame (frame));
950 is_surrogate_for_selected_frame (struct frame *f)
952 struct device *d = XDEVICE (f->device);
953 struct frame *dsf = device_selected_frame (d);
955 /* Can't be a surrogate for ourselves. */
959 if (!FRAME_HAS_MINIBUF_P (dsf) &&
960 f == XFRAME (WINDOW_FRAME (XWINDOW (FRAME_MINIBUF_WINDOW (dsf)))))
967 frame_matches_frametype (Lisp_Object frame, Lisp_Object type)
969 struct frame *f = XFRAME (frame);
973 CHECK_LIVE_WINDOW (type);
975 if (EQ (FRAME_MINIBUF_WINDOW (f), type)
976 /* Check that F either is, or has forwarded
977 its focus to, TYPE's frame. */
978 && (EQ (WINDOW_FRAME (XWINDOW (type)), frame)
979 || EQ (WINDOW_FRAME (XWINDOW (type)),
980 FRAME_FOCUS_FRAME (f))))
987 if (EQ (type, Qvisible) || EQ (type, Qiconic) || EQ (type, Qvisible_iconic)
988 || EQ (type, Qvisible_nomini) || EQ (type, Qiconic_nomini)
989 || EQ (type, Qvisible_iconic_nomini))
990 FRAME_SAMPLE_VISIBILITY (f);
996 type = Qvisible_iconic;
998 if (EQ (type, Qvisible))
999 return FRAME_VISIBLE_P (f);
1000 if (EQ (type, Qiconic))
1001 return FRAME_ICONIFIED_P (f);
1002 if (EQ (type, Qinvisible))
1003 return !FRAME_VISIBLE_P (f) && !FRAME_ICONIFIED_P (f);
1004 if (EQ (type, Qvisible_iconic))
1005 return FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f);
1006 if (EQ (type, Qinvisible_iconic))
1007 return !FRAME_VISIBLE_P (f);
1009 if (EQ (type, Qnomini))
1010 return !FRAME_MINIBUF_ONLY_P (f);
1011 if (EQ (type, Qvisible_nomini))
1012 return FRAME_VISIBLE_P (f) && !FRAME_MINIBUF_ONLY_P (f);
1013 if (EQ (type, Qiconic_nomini))
1014 return FRAME_ICONIFIED_P (f) && !FRAME_MINIBUF_ONLY_P (f);
1015 if (EQ (type, Qinvisible_nomini))
1016 return !FRAME_VISIBLE_P (f) && !FRAME_ICONIFIED_P (f) &&
1017 !FRAME_MINIBUF_ONLY_P (f);
1018 if (EQ (type, Qvisible_iconic_nomini))
1019 return ((FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f))
1020 && !FRAME_MINIBUF_ONLY_P (f));
1021 if (EQ (type, Qinvisible_iconic_nomini))
1022 return !FRAME_VISIBLE_P (f) && !FRAME_MINIBUF_ONLY_P (f);
1028 device_matches_console_spec (Lisp_Object frame, Lisp_Object device,
1029 Lisp_Object console)
1031 if (EQ (console, Qwindow_system))
1032 return DEVICE_WIN_P (XDEVICE (device));
1034 console = (DEVICE_CONSOLE (XDEVICE (FRAME_DEVICE (XFRAME (frame)))));
1035 if (DEVICEP (console))
1036 return EQ (device, console);
1037 if (CONSOLEP (console))
1038 return EQ (DEVICE_CONSOLE (XDEVICE (device)), console);
1039 if (valid_console_type_p (console))
1040 return EQ (DEVICE_TYPE (XDEVICE (device)), console);
1044 /* Return the next frame in the frame list after FRAME.
1045 FRAMETYPE and CONSOLE control which frames and devices
1046 are considered; see `next-frame'. */
1049 next_frame_internal (Lisp_Object frame, Lisp_Object frametype,
1050 Lisp_Object console, int called_from_delete_device)
1053 int started_over = 0;
1055 /* If this frame is dead, it won't be in frame_list, and we'll loop
1056 forever. Forestall that. */
1057 CHECK_LIVE_FRAME (frame);
1061 Lisp_Object devcons, concons;
1063 DEVICE_LOOP_NO_BREAK (devcons, concons)
1065 Lisp_Object device = XCAR (devcons);
1066 Lisp_Object frmcons;
1068 if (!device_matches_console_spec (frame, device, console))
1071 DEVICE_FRAME_LOOP (frmcons, XDEVICE (device))
1073 Lisp_Object f = XCAR (frmcons);
1076 /* #### Doing this here is bad and is now
1077 unnecessary. The real bug was that f->iconified
1078 was never, ever updated unless a user explicitly
1079 called frame-iconified-p. That has now been
1080 fixed. With this change removed all of the other
1081 changes made to support this routine having the
1082 called_from_delete_device arg could be removed.
1083 But it is too close to release to do that now. */
1085 /* Make sure the visibility and iconified flags are
1086 up-to-date unless we're being deleted. */
1087 if (!called_from_delete_device)
1089 Fframe_iconified_p (f);
1090 Fframe_visible_p (f);
1094 /* Decide whether this frame is eligible to be returned. */
1096 /* If we've looped all the way around without finding any
1097 eligible frames, return the original frame. */
1101 if (frame_matches_frametype (f, frametype))
1109 /* We hit the end of the list, and need to start over again. */
1117 next_frame (Lisp_Object frame, Lisp_Object frametype, Lisp_Object console)
1119 return next_frame_internal (frame, frametype, console, 0);
1122 /* Return the previous frame in the frame list before FRAME.
1123 FRAMETYPE and CONSOLE control which frames and devices
1124 are considered; see `next-frame'. */
1127 prev_frame (Lisp_Object frame, Lisp_Object frametype, Lisp_Object console)
1129 Lisp_Object devcons, concons;
1132 /* If this frame is dead, it won't be in frame_list, and we'll loop
1133 forever. Forestall that. */
1134 CHECK_LIVE_FRAME (frame);
1137 DEVICE_LOOP_NO_BREAK (devcons, concons)
1139 Lisp_Object device = XCAR (devcons);
1140 Lisp_Object frmcons;
1142 if (!device_matches_console_spec (frame, device, console))
1145 DEVICE_FRAME_LOOP (frmcons, XDEVICE (device))
1147 Lisp_Object f = XCAR (frmcons);
1149 if (EQ (frame, f) && !NILP (prev))
1152 /* Decide whether this frame is eligible to be returned,
1153 according to frametype. */
1155 if (frame_matches_frametype (f, frametype))
1161 /* We've scanned the entire list. */
1163 /* We went through the whole frame list without finding a single
1164 acceptable frame. Return the original frame. */
1167 /* There were no acceptable frames in the list before FRAME; otherwise,
1168 we would have returned directly from the loop. Since PREV is the last
1169 acceptable frame in the list, return it. */
1173 DEFUN ("next-frame", Fnext_frame, 0, 3, 0, /*
1174 Return the next frame of the right type in the frame list after FRAME.
1175 FRAMETYPE controls which frames are eligible to be returned; all
1176 others will be skipped. Note that if there is only one eligible
1177 frame, then `next-frame' called repeatedly will always return
1178 the same frame, and if there is no eligible frame, then FRAME is
1181 Possible values for FRAMETYPE are
1183 'visible Consider only frames that are visible.
1184 'iconic Consider only frames that are iconic.
1185 'invisible Consider only frames that are invisible
1186 (this is different from iconic).
1187 'visible-iconic Consider frames that are visible or iconic.
1188 'invisible-iconic Consider frames that are invisible or iconic.
1189 'nomini Consider all frames except minibuffer-only ones.
1190 'visible-nomini Like `visible' but omits minibuffer-only frames.
1191 'iconic-nomini Like `iconic' but omits minibuffer-only frames.
1192 'invisible-nomini Like `invisible' but omits minibuffer-only frames.
1193 'visible-iconic-nomini Like `visible-iconic' but omits minibuffer-only
1195 'invisible-iconic-nomini Like `invisible-iconic' but omits minibuffer-only
1197 any other value Consider all frames.
1199 If FRAMETYPE is omitted, 'nomini is used. A FRAMETYPE of 0 (a number)
1200 is treated like 'iconic, for backwards compatibility.
1202 If FRAMETYPE is a window, include only its own frame and any frame now
1203 using that window as the minibuffer.
1205 Optional third argument CONSOLE controls which consoles or devices the
1206 returned frame may be on. If CONSOLE is a console, return frames only
1207 on that console. If CONSOLE is a device, return frames only on that
1208 device. If CONSOLE is a console type, return frames only on consoles
1209 of that type. If CONSOLE is 'window-system, return any frames on any
1210 window-system consoles. If CONSOLE is nil or omitted, return frames only
1211 on the FRAME's console. Otherwise, all frames are considered.
1213 (frame, frametype, console))
1215 XSETFRAME (frame, decode_frame (frame));
1217 return next_frame (frame, frametype, console);
1220 DEFUN ("previous-frame", Fprevious_frame, 0, 3, 0, /*
1221 Return the next frame of the right type in the frame list after FRAME.
1222 FRAMETYPE controls which frames are eligible to be returned; all
1223 others will be skipped. Note that if there is only one eligible
1224 frame, then `previous-frame' called repeatedly will always return
1225 the same frame, and if there is no eligible frame, then FRAME is
1228 See `next-frame' for an explanation of the FRAMETYPE and CONSOLE
1231 (frame, frametype, console))
1233 XSETFRAME (frame, decode_frame (frame));
1235 return prev_frame (frame, frametype, console);
1238 /* Return any frame for which PREDICATE is non-zero, or return Qnil
1239 if there aren't any. */
1242 find_some_frame (int (*predicate) (Lisp_Object, void *),
1245 Lisp_Object framecons, devcons, concons;
1247 FRAME_LOOP_NO_BREAK (framecons, devcons, concons)
1249 Lisp_Object frame = XCAR (framecons);
1251 if ((predicate) (frame, closure))
1260 /* extern void free_line_insertion_deletion_costs (struct frame *f); */
1262 /* Return 1 if it is ok to delete frame F;
1263 0 if all frames aside from F are invisible.
1264 (Exception: if F is a stream frame, it's OK to delete if
1265 any other frames exist.) */
1268 other_visible_frames_internal (struct frame *f, int called_from_delete_device)
1272 XSETFRAME (frame, f);
1273 if (FRAME_STREAM_P (f))
1274 return !EQ (frame, next_frame_internal (frame, Qt, Qt,
1275 called_from_delete_device));
1276 return !EQ (frame, next_frame_internal (frame, Qvisible_iconic_nomini, Qt,
1277 called_from_delete_device));
1281 other_visible_frames (struct frame *f)
1283 return other_visible_frames_internal (f, 0);
1288 If FORCE is non-zero, allow deletion of the only frame.
1290 If CALLED_FROM_DELETE_DEVICE is non-zero, then, if
1291 deleting the last frame on a device, just delete it,
1292 instead of calling `delete-device'.
1294 If FROM_IO_ERROR is non-zero, then the frame is gone due
1295 to an I/O error. This affects what happens if we exit
1296 (we do an emergency exit instead of `save-buffers-kill-emacs'.)
1300 delete_frame_internal (struct frame *f, int force,
1301 int called_from_delete_device,
1304 /* This function can GC */
1305 int minibuffer_selected;
1307 struct console *con;
1310 Lisp_Object console;
1311 struct gcpro gcpro1;
1313 /* OK to delete an already deleted frame. */
1314 if (! FRAME_LIVE_P (f))
1317 XSETFRAME (frame, f);
1320 device = FRAME_DEVICE (f);
1321 d = XDEVICE (device);
1322 console = DEVICE_CONSOLE (d);
1323 con = XCONSOLE (console);
1325 if (!called_from_delete_device &&
1326 !(MAYBE_INT_DEVMETH (d, device_implementation_flags, ())
1327 & XDEVIMPF_FRAMELESS_OK))
1329 /* If we're deleting the only non-minibuffer frame on the
1330 device, delete the device. */
1331 if (EQ (frame, next_frame (frame, Qnomini, FRAME_DEVICE (f))))
1333 delete_device_internal (d, force, 0, from_io_error);
1339 /* In FSF, delete-frame will not normally allow you to delete the
1340 last visible frame. This was too annoying, so we changed it to the
1341 only frame. However, this would let people shoot themselves by
1342 deleting all frames which were either visible or iconified and thus
1343 losing any way of communicating with the still running XEmacs process.
1344 So we put it back. */
1345 if (!force && !allow_deletion_of_last_visible_frame &&
1346 !other_visible_frames_internal (f, called_from_delete_device))
1347 error ("Attempt to delete the sole visible or iconified frame");
1349 /* Does this frame have a minibuffer, and is it the surrogate
1350 minibuffer for any other frame? */
1351 if (FRAME_HAS_MINIBUF_P (f))
1353 Lisp_Object frmcons, devcons, concons;
1355 FRAME_LOOP_NO_BREAK (frmcons, devcons, concons)
1357 Lisp_Object this = XCAR (frmcons);
1359 if (! EQ (this, frame)
1360 && EQ (frame, (WINDOW_FRAME
1362 (FRAME_MINIBUF_WINDOW (XFRAME (this)))))))
1364 /* We've found another frame whose minibuffer is on
1367 ("Attempt to delete a surrogate minibuffer frame", frame);
1372 /* Test for popup frames hanging around. */
1373 /* Deletion of a parent frame with popups is deadly. */
1375 Lisp_Object frmcons, devcons, concons;
1377 FRAME_LOOP_NO_BREAK (frmcons, devcons, concons)
1379 Lisp_Object this = XCAR (frmcons);
1382 if (! EQ (this, frame))
1384 struct device *devcons_d = XDEVICE (XCAR (devcons));
1385 if (EQ (frame, DEVMETH_OR_GIVEN (devcons_d, get_frame_parent,
1388 /* We've found a popup frame whose parent is this frame. */
1390 ("Attempt to delete a frame with live popups", frame);
1395 /* Before here, we haven't made any dangerous changes (just checked for
1396 error conditions). Now run the delete-frame-hook. Remember that
1397 user code there could do any number of dangerous things, including
1398 signalling an error. */
1400 va_run_hook_with_args (Qdelete_frame_hook, 1, frame);
1402 if (!FRAME_LIVE_P (f)) /* Make sure the delete-frame-hook didn't */
1403 { /* go ahead and delete anything. */
1408 /* Call the delete-device-hook and delete-console-hook now if
1409 appropriate, before we do any dangerous things -- they too could
1411 if (XINT (Flength (DEVICE_FRAME_LIST (d))) == 1)
1413 va_run_hook_with_args (Qdelete_device_hook, 1, device);
1414 if (!FRAME_LIVE_P (f)) /* Make sure the delete-device-hook didn't */
1415 { /* go ahead and delete anything. */
1420 if (XINT (Flength (CONSOLE_DEVICE_LIST (con))) == 1)
1422 va_run_hook_with_args (Qdelete_console_hook, 1, console);
1423 if (!FRAME_LIVE_P (f)) /* Make sure the delete-console-hook didn't */
1424 { /* go ahead and delete anything. */
1431 minibuffer_selected = EQ (minibuf_window, Fselected_window (Qnil));
1433 /* If we were focused on this frame, then we're not any more.
1434 Assume that we lost the focus; that way, the call to
1435 Fselect_frame() below won't end up making us explicitly
1436 focus on another frame, which is generally undesirable in
1437 a point-to-type world. If our mouse ends up sitting over
1438 another frame, we will receive a FocusIn event and end up
1439 making that frame the selected frame.
1441 #### This may not be an ideal solution in a click-to-type
1442 world (in that case, we might want to explicitly choose
1443 another frame to have the focus, rather than relying on
1444 the WM, which might focus on a frame in a different app
1445 or focus on nothing at all). But there's no easy way
1446 to detect which focus model we're running on, and the
1447 alternative is more heinous. */
1449 if (EQ (frame, DEVICE_FRAME_WITH_FOCUS_REAL (d)))
1450 DEVICE_FRAME_WITH_FOCUS_REAL (d) = Qnil;
1451 if (EQ (frame, DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d)))
1452 DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d) = Qnil;
1453 if (EQ (frame, DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d)))
1454 DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d) = Qnil;
1456 /* Don't allow the deleted frame to remain selected.
1457 Note that in the former scheme of things, this would
1458 have caused us to regain the focus. This no longer
1459 applies (see above); I think the new behavior is more
1460 logical. If someone disagrees, it can always be
1461 changed (or a new user variable can be introduced, ugh.) */
1462 if (EQ (frame, DEVICE_SELECTED_FRAME (d)))
1466 /* If this is a popup frame, select its parent if possible.
1467 Otherwise, find another visible frame; if none, just take any frame.
1468 First try the same device, then the same console. */
1470 next = DEVMETH_OR_GIVEN (d, get_frame_parent, (f), Qnil);
1471 if (NILP (next) || EQ (next, frame) || ! FRAME_LIVE_P (XFRAME (next)))
1472 next = next_frame_internal (frame, Qvisible, device,
1473 called_from_delete_device);
1474 if (NILP (next) || EQ (next, frame))
1475 next = next_frame_internal (frame, Qvisible, console,
1476 called_from_delete_device);
1477 if (NILP (next) || EQ (next, frame))
1478 next = next_frame_internal (frame, Qvisible, Qt,
1479 called_from_delete_device);
1480 if (NILP (next) || EQ (next, frame))
1481 next = next_frame_internal (frame, Qt, device,
1482 called_from_delete_device);
1483 if (NILP (next) || EQ (next, frame))
1484 next = next_frame_internal (frame, Qt, console,
1485 called_from_delete_device);
1486 if (NILP (next) || EQ (next, frame))
1487 next = next_frame_internal (frame, Qt, Qt, called_from_delete_device);
1489 /* if we haven't found another frame at this point
1490 then there aren't any. */
1491 if (NILP (next) || EQ (next, frame))
1496 /* if this is the global selected frame, select another one. */
1497 if (EQ (frame, Fselected_frame (Qnil)))
1499 Fselect_frame (next);
1503 * If the new frame we just selected is on a different
1504 * device then we still need to change DEVICE_SELECTED_FRAME(d)
1505 * to a live frame, if there are any left on this device.
1507 if (!EQ (device, FRAME_DEVICE(XFRAME(next))))
1509 Lisp_Object next_f =
1510 next_frame_internal (frame, Qt, device,
1511 called_from_delete_device);
1512 if (NILP (next_f) || EQ (next_f, frame))
1513 set_device_selected_frame (d, Qnil);
1515 set_device_selected_frame (d, next_f);
1517 else if (! did_select)
1518 set_device_selected_frame (d, next);
1523 /* Don't allow minibuf_window to remain on a deleted frame. */
1524 if (EQ (f->minibuffer_window, minibuf_window))
1526 struct frame *sel_frame = selected_frame ();
1527 Fset_window_buffer (sel_frame->minibuffer_window,
1528 XWINDOW (minibuf_window)->buffer, Qt);
1529 minibuf_window = sel_frame->minibuffer_window;
1531 /* If the dying minibuffer window was selected,
1532 select the new one. */
1533 if (minibuffer_selected)
1534 Fselect_window (minibuf_window, Qnil);
1537 /* After this point, no errors must be allowed to occur. */
1539 #ifdef HAVE_MENUBARS
1540 free_frame_menubars (f);
1542 #ifdef HAVE_SCROLLBARS
1543 free_frame_scrollbars (f);
1545 #ifdef HAVE_TOOLBARS
1546 free_frame_toolbars (f);
1548 free_frame_gutters (f);
1550 /* This must be done before the window and window_mirror structures
1551 are freed. The scrollbar information is attached to them. */
1552 MAYBE_FRAMEMETH (f, delete_frame, (f));
1554 /* Mark all the windows that used to be on FRAME as deleted, and then
1555 remove the reference to them. */
1556 delete_all_subwindows (XWINDOW (f->root_window));
1557 f->root_window = Qnil;
1559 /* clear out the cached glyph information */
1560 if (f->subwindow_cachels)
1562 Dynarr_free (f->subwindow_cachels);
1563 f->subwindow_cachels = 0;
1566 /* Remove the frame now from the list. This way, any events generated
1567 on this frame by the maneuvers below will disperse themselves. */
1569 /* This used to be Fdelq(), but that will cause a seg fault if the
1570 QUIT checker happens to get invoked, because the frame list is in
1571 an inconsistent state. */
1572 d->frame_list = delq_no_quit (frame, d->frame_list);
1573 RESET_CHANGED_SET_FLAGS;
1578 free_window_mirror (f->root_mirror);
1579 /* free_line_insertion_deletion_costs (f); */
1581 /* If we've deleted the last non-minibuf frame, then try to find
1583 if (EQ (frame, CONSOLE_LAST_NONMINIBUF_FRAME (con)))
1585 Lisp_Object frmcons, devcons;
1587 set_console_last_nonminibuf_frame (con, Qnil);
1589 CONSOLE_FRAME_LOOP_NO_BREAK (frmcons, devcons, con)
1591 Lisp_Object ecran = XCAR (frmcons);
1592 if (!FRAME_MINIBUF_ONLY_P (XFRAME (ecran)))
1594 set_console_last_nonminibuf_frame (con, ecran);
1595 goto double_break_1;
1602 /* The following test is degenerate FALSE */
1603 if (called_from_delete_device < 0)
1604 /* then we're being called from delete-console, and we shouldn't
1605 try to find another default-minibuffer frame for the console.
1607 con->default_minibuffer_frame = Qnil;
1610 /* If we've deleted this console's default_minibuffer_frame, try to
1611 find another one. Prefer minibuffer-only frames, but also notice
1612 frames with other windows. */
1613 if (EQ (frame, con->default_minibuffer_frame))
1615 Lisp_Object frmcons, devcons;
1616 /* The last frame we saw with a minibuffer, minibuffer-only or not. */
1617 Lisp_Object frame_with_minibuf;
1618 /* Some frame we found on the same console, or nil if there are none. */
1619 Lisp_Object frame_on_same_console;
1621 frame_on_same_console = Qnil;
1622 frame_with_minibuf = Qnil;
1624 set_console_last_nonminibuf_frame (con, Qnil);
1626 CONSOLE_FRAME_LOOP_NO_BREAK (frmcons, devcons, con)
1631 this = XCAR (frmcons);
1634 /* Consider only frames on the same console
1635 and only those with minibuffers. */
1636 if (FRAME_HAS_MINIBUF_P (f1))
1638 frame_with_minibuf = this;
1639 if (FRAME_MINIBUF_ONLY_P (f1))
1640 goto double_break_2;
1643 frame_on_same_console = this;
1647 if (!NILP (frame_on_same_console))
1649 /* We know that there must be some frame with a minibuffer out
1650 there. If this were not true, all of the frames present
1651 would have to be minibuffer-less, which implies that at some
1652 point their minibuffer frames must have been deleted, but
1653 that is prohibited at the top; you can't delete surrogate
1654 minibuffer frames. */
1655 if (NILP (frame_with_minibuf))
1658 con->default_minibuffer_frame = frame_with_minibuf;
1661 /* No frames left on this console--say no minibuffer either. */
1662 con->default_minibuffer_frame = Qnil;
1665 nuke_all_frame_slots (f); /* nobody should be accessing the device
1666 or anything else any more, and making
1667 them Qnil allows for better GC'ing
1668 in case a pointer to the dead frame
1669 continues to hang around. */
1670 f->framemeths = dead_console_methods;
1675 io_error_delete_frame (Lisp_Object frame)
1677 delete_frame_internal (XFRAME (frame), 1, 0, 1);
1680 DEFUN ("delete-frame", Fdelete_frame, 0, 2, "", /*
1681 Delete FRAME, permanently eliminating it from use.
1682 If omitted, FRAME defaults to the selected frame.
1683 A frame may not be deleted if its minibuffer is used by other frames.
1684 Normally, you cannot delete the last non-minibuffer-only frame (you must
1685 use `save-buffers-kill-emacs' or `kill-emacs'). However, if optional
1686 second argument FORCE is non-nil, you can delete the last frame. (This
1687 will automatically call `save-buffers-kill-emacs'.)
1691 /* This function can GC */
1696 f = selected_frame ();
1697 XSETFRAME (frame, f);
1701 CHECK_FRAME (frame);
1705 delete_frame_internal (f, !NILP (force), 0, 0);
1710 /* Return mouse position in character cell units. */
1713 mouse_pixel_position_1 (struct device *d, Lisp_Object *frame,
1716 switch (DEVMETH_OR_GIVEN (d, get_mouse_position, (d, frame, x, y), -1))
1726 *frame = DEVICE_SELECTED_FRAME (d);
1730 abort (); /* method is incorrectly written */
1736 DEFUN ("mouse-pixel-position", Fmouse_pixel_position, 0, 1, 0, /*
1737 Return a list (WINDOW X . Y) giving the current mouse window and position.
1738 The position is given in pixel units, where (0, 0) is the upper-left corner.
1740 When the cursor is not over a window, the return value is a list (nil nil).
1742 DEVICE specifies the device on which to read the mouse position, and
1743 defaults to the selected device. If the device is a mouseless terminal
1744 or Emacs hasn't been programmed to read its mouse position, it returns
1745 the device's selected window for WINDOW and nil for X and Y.
1749 struct device *d = decode_device (device);
1751 Lisp_Object window = Qnil;
1752 Lisp_Object x = Qnil;
1753 Lisp_Object y = Qnil;
1756 if (mouse_pixel_position_1 (d, &frame, &intx, &inty) > 0)
1759 find_window_by_pixel_pos (intx, inty, XFRAME (frame)->root_window);
1762 XSETWINDOW (window, w);
1764 /* Adjust the position to be relative to the window. */
1765 intx -= w->pixel_left;
1766 inty -= w->pixel_top;
1771 else if (FRAMEP (frame))
1772 window = FRAME_SELECTED_WINDOW (XFRAME (frame));
1774 return Fcons (window, Fcons (x, y));
1777 DEFUN ("mouse-position", Fmouse_position, 0, 1, 0, /*
1778 Return a list (WINDOW X . Y) giving the current mouse window and position.
1779 The position is of a character under cursor, where (0, 0) is the upper-left
1780 corner of the window.
1782 When the cursor is not over a character, or not over a window, the return
1783 value is a list (nil nil).
1785 DEVICE specifies the device on which to read the mouse position, and
1786 defaults to the selected device. If the device is a mouseless terminal
1787 or Emacs hasn't been programmed to read its mouse position, it returns
1788 the device's selected window for WINDOW and nil for X and Y.
1792 struct device *d = decode_device (device);
1794 Lisp_Object frame, window = Qnil, lisp_x = Qnil, lisp_y = Qnil;
1795 int x, y, obj_x, obj_y;
1796 Bufpos bufpos, closest;
1797 Charcount modeline_closest;
1798 Lisp_Object obj1, obj2;
1800 if (mouse_pixel_position_1 (d, &frame, &x, &y) > 0)
1802 int res = pixel_to_glyph_translation (XFRAME (frame), x, y, &x, &y,
1803 &obj_x, &obj_y, &w, &bufpos,
1804 &closest, &modeline_closest,
1806 if (res == OVER_TEXT)
1808 lisp_x = make_int (x);
1809 lisp_y = make_int (y);
1810 XSETWINDOW (window, w);
1813 else if (FRAMEP (frame))
1814 window = FRAME_SELECTED_WINDOW (XFRAME (frame));
1816 return Fcons (window, Fcons (lisp_x, lisp_y));
1819 DEFUN ("mouse-position-as-motion-event", Fmouse_position_as_motion_event, 0, 1, 0, /*
1820 Return the current mouse position as a motion event.
1821 This allows you to call the standard event functions such as
1822 `event-over-toolbar-p' to determine where the mouse is.
1824 DEVICE specifies the device on which to read the mouse position, and
1825 defaults to the selected device. If the mouse position can't be determined
1826 \(e.g. DEVICE is a TTY device), nil is returned instead of an event.
1830 struct device *d = decode_device (device);
1834 if (mouse_pixel_position_1 (d, &frame, &intx, &inty))
1836 Lisp_Object event = Fmake_event (Qnil, Qnil);
1837 XEVENT (event)->event_type = pointer_motion_event;
1838 XEVENT (event)->channel = frame;
1839 XEVENT (event)->event.motion.x = intx;
1840 XEVENT (event)->event.motion.y = inty;
1847 DEFUN ("set-mouse-position", Fset_mouse_position, 3, 3, 0, /*
1848 Move the mouse pointer to the center of character cell (X,Y) in WINDOW.
1849 Note, this is a no-op for an X frame that is not visible.
1850 If you have just created a frame, you must wait for it to become visible
1851 before calling this function on it, like this.
1852 (while (not (frame-visible-p frame)) (sleep-for .5))
1853 Note also: Warping the mouse is contrary to the ICCCM, so be very sure
1854 that the behavior won't end up being obnoxious!
1861 CHECK_LIVE_WINDOW (window);
1865 /* Warping the mouse will cause EnterNotify and Focus events under X. */
1866 w = XWINDOW (window);
1867 glyph_to_pixel_translation (w, XINT (x), XINT (y), &pix_x, &pix_y);
1869 MAYBE_FRAMEMETH (XFRAME (w->frame), set_mouse_position, (w, pix_x, pix_y));
1874 DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position, 3, 3, 0, /*
1875 Move the mouse pointer to pixel position (X,Y) in WINDOW.
1876 Note, this is a no-op for an X frame that is not visible.
1877 If you have just created a frame, you must wait for it to become visible
1878 before calling this function on it, like this.
1879 (while (not (frame-visible-p frame)) (sleep-for .5))
1885 CHECK_LIVE_WINDOW (window);
1889 /* Warping the mouse will cause EnterNotify and Focus events under X. */
1890 w = XWINDOW (window);
1891 FRAMEMETH (XFRAME (w->frame), set_mouse_position, (w, XINT (x), XINT (y)));
1896 DEFUN ("make-frame-visible", Fmake_frame_visible, 0, 1, 0, /*
1897 Make the frame FRAME visible (assuming it is an X-window).
1898 If omitted, FRAME defaults to the currently selected frame.
1899 Also raises the frame so that nothing obscures it.
1903 struct frame *f = decode_frame (frame);
1905 MAYBE_FRAMEMETH (f, make_frame_visible, (f));
1909 DEFUN ("make-frame-invisible", Fmake_frame_invisible, 0, 2, 0, /*
1910 Unconditionally removes frame from the display (assuming it is an X-window).
1911 If omitted, FRAME defaults to the currently selected frame.
1912 If what you want to do is iconify the frame (if the window manager uses
1913 icons) then you should call `iconify-frame' instead.
1914 Normally you may not make FRAME invisible if all other frames are invisible
1915 and uniconified, but if the second optional argument FORCE is non-nil,
1920 struct frame *f, *sel_frame;
1923 f = decode_frame (frame);
1924 d = XDEVICE (FRAME_DEVICE (f));
1925 sel_frame = XFRAME (DEVICE_SELECTED_FRAME (d));
1927 if (NILP (force) && !other_visible_frames (f))
1928 error ("Attempt to make invisible the sole visible or iconified frame");
1930 /* Don't allow minibuf_window to remain on a deleted frame. */
1931 if (EQ (f->minibuffer_window, minibuf_window))
1933 Fset_window_buffer (sel_frame->minibuffer_window,
1934 XWINDOW (minibuf_window)->buffer, Qt);
1935 minibuf_window = sel_frame->minibuffer_window;
1938 MAYBE_FRAMEMETH (f, make_frame_invisible, (f));
1943 DEFUN ("iconify-frame", Ficonify_frame, 0, 1, "", /*
1944 Make the frame FRAME into an icon, if the window manager supports icons.
1945 If omitted, FRAME defaults to the currently selected frame.
1949 struct frame *f, *sel_frame;
1952 f = decode_frame (frame);
1953 d = XDEVICE (FRAME_DEVICE (f));
1954 sel_frame = XFRAME (DEVICE_SELECTED_FRAME (d));
1956 /* Don't allow minibuf_window to remain on a deleted frame. */
1957 if (EQ (f->minibuffer_window, minibuf_window))
1959 Fset_window_buffer (sel_frame->minibuffer_window,
1960 XWINDOW (minibuf_window)->buffer, Qt);
1961 minibuf_window = sel_frame->minibuffer_window;
1964 MAYBE_FRAMEMETH (f, iconify_frame, (f));
1969 DEFUN ("deiconify-frame", Fdeiconify_frame, 0, 1, 0, /*
1970 Open (de-iconify) the iconified frame FRAME.
1971 Under X, this is currently the same as `make-frame-visible'.
1972 If omitted, FRAME defaults to the currently selected frame.
1973 Also raises the frame so that nothing obscures it.
1977 return Fmake_frame_visible (frame);
1980 /* FSF returns 'icon for iconized frames. What a crock! */
1982 DEFUN ("frame-visible-p", Fframe_visible_p, 0, 1, 0, /*
1983 Return non NIL if FRAME is now "visible" (actually in use for display).
1984 A frame that is not visible is not updated, and, if it works through a
1985 window system, may not show at all.
1986 N.B. Under X "visible" means Mapped. It the window is mapped but not
1987 actually visible on screen then frame_visible returns 'hidden.
1991 struct frame *f = decode_frame (frame);
1992 int visible = FRAMEMETH_OR_GIVEN (f, frame_visible_p, (f), f->visible);
1993 return visible ? ( visible > 0 ? Qt : Qhidden ) : Qnil;
1996 DEFUN ("frame-totally-visible-p", Fframe_totally_visible_p, 0, 1, 0, /*
1997 Return t if frame is not obscured by any other window system windows.
1998 Always returns t for tty frames.
2002 struct frame *f = decode_frame (frame);
2003 return (FRAMEMETH_OR_GIVEN (f, frame_totally_visible_p, (f), f->visible)
2007 DEFUN ("frame-iconified-p", Fframe_iconified_p, 0, 1, 0, /*
2008 Return t if FRAME is iconified.
2009 Not all window managers use icons; some merely unmap the window, so this
2010 function is not the inverse of `frame-visible-p'. It is possible for a
2011 frame to not be visible and not be iconified either. However, if the
2012 frame is iconified, it will not be visible.
2016 struct frame *f = decode_frame (frame);
2019 f->iconified = FRAMEMETH_OR_GIVEN (f, frame_iconified_p, (f), 0);
2020 return f->iconified ? Qt : Qnil;
2023 DEFUN ("visible-frame-list", Fvisible_frame_list, 0, 1, 0, /*
2024 Return a list of all frames now "visible" (being updated).
2025 If DEVICE is specified only frames on that device will be returned.
2026 Note that under virtual window managers not all these frame are necessarily
2031 Lisp_Object devcons, concons;
2037 DEVICE_LOOP_NO_BREAK (devcons, concons)
2039 assert (DEVICEP (XCAR (devcons)));
2041 if (NILP (device) || EQ (device, XCAR (devcons)))
2043 Lisp_Object frmcons;
2045 DEVICE_FRAME_LOOP (frmcons, XDEVICE (XCAR (devcons)))
2047 Lisp_Object frame = XCAR (frmcons);
2049 if (FRAME_VISIBLE_P(f))
2050 value = Fcons (frame, value);
2059 DEFUN ("raise-frame", Fraise_frame, 0, 1, "", /*
2060 Bring FRAME to the front, so it occludes any frames it overlaps.
2061 If omitted, FRAME defaults to the currently selected frame.
2062 If FRAME is invisible, make it visible.
2063 If Emacs is displaying on an ordinary terminal or some other device which
2064 doesn't support multiple overlapping frames, this function does nothing.
2068 struct frame *f = decode_frame (frame);
2070 /* Do like the documentation says. */
2071 Fmake_frame_visible (frame);
2072 MAYBE_FRAMEMETH (f, raise_frame, (f));
2076 DEFUN ("lower-frame", Flower_frame, 0, 1, "", /*
2077 Send FRAME to the back, so it is occluded by any frames that overlap it.
2078 If omitted, FRAME defaults to the currently selected frame.
2079 If Emacs is displaying on an ordinary terminal or some other device which
2080 doesn't support multiple overlapping frames, this function does nothing.
2084 struct frame *f = decode_frame (frame);
2086 MAYBE_FRAMEMETH (f, lower_frame, (f));
2090 /* Ben thinks there is no need for `redirect-frame-focus' or `frame-focus',
2091 crockish FSFmacs functions. See summary on focus in event-stream.c. */
2094 /***************************************************************************/
2095 /* frame properties */
2096 /***************************************************************************/
2098 static void internal_set_frame_size (struct frame *f, int cols, int rows,
2102 store_minibuf_frame_prop (struct frame *f, Lisp_Object val)
2105 XSETFRAME (frame, f);
2109 if (! MINI_WINDOW_P (XWINDOW (val)))
2111 ("Surrogate minibuffer windows must be minibuffer windows",
2114 if (FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f))
2116 ("Can't change the surrogate minibuffer of a frame with its own minibuffer", frame);
2118 /* Install the chosen minibuffer window, with proper buffer. */
2119 f->minibuffer_window = val;
2121 else if (EQ (val, Qt))
2123 if (FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f))
2125 ("Frame already has its own minibuffer", frame);
2128 setup_normal_frame (f);
2129 f->mirror_dirty = 1;
2131 update_frame_window_mirror (f);
2132 internal_set_frame_size (f, f->width, f->height, 1);
2139 /* possible code if you want to have symbols such as `default-background'
2140 map to setting the background of `default', etc. */
2143 dissect_as_face_setting (Lisp_Object sym, Lisp_Object *face_out,
2144 Lisp_Object *face_prop_out)
2146 Lisp_Object list = Vbuilt_in_face_specifiers;
2152 s = symbol_name (XSYMBOL (sym));
2154 while (!NILP (list))
2156 Lisp_Object prop = Fcar (list);
2157 Lisp_String *prop_name;
2159 if (!SYMBOLP (prop))
2161 prop_name = symbol_name (XSYMBOL (prop));
2162 if (string_length (s) > string_length (prop_name) + 1
2163 && !memcmp (string_data (prop_name),
2164 string_data (s) + string_length (s)
2165 - string_length (prop_name),
2166 string_length (prop_name))
2167 && string_data (s)[string_length (s) - string_length (prop_name)
2171 Ffind_face (make_string (string_data (s),
2173 - string_length (prop_name)
2178 *face_prop_out = prop;
2192 get_property_alias (Lisp_Object prop)
2196 Lisp_Object alias = Qnil;
2199 alias = Fget (prop, Qframe_property_alias, Qnil);
2209 /* #### Using this to modify the internal border width has no effect
2210 because the change isn't propagated to the windows. Are there
2211 other properties which this claims to handle, but doesn't?
2213 But of course. This stuff needs more work, but it's a lot closer
2214 to sanity now than before with the horrible frame-params stuff. */
2216 DEFUN ("set-frame-properties", Fset_frame_properties, 2, 2, 0, /*
2217 Change some properties of a frame.
2218 PLIST is a property list.
2219 You can also change frame properties individually using `set-frame-property',
2220 but it may be more efficient to change many properties at once.
2222 Frame properties can be retrieved using `frame-property' or `frame-properties'.
2224 The following symbols etc. have predefined meanings:
2226 name Name of the frame. Used with X resources.
2227 Unchangeable after creation.
2229 height Height of the frame, in lines.
2231 width Width of the frame, in characters.
2233 minibuffer Gives the minibuffer behavior for this frame. Either
2234 t (frame has its own minibuffer), `only' (frame is
2235 a minibuffer-only frame), or a window (frame uses that
2236 window, which is on another frame, as the minibuffer).
2238 unsplittable If non-nil, frame cannot be split by `display-buffer'.
2240 current-display-table, menubar-visible-p, left-margin-width,
2241 right-margin-width, minimum-line-ascent, minimum-line-descent,
2242 use-left-overflow, use-right-overflow, scrollbar-width, scrollbar-height,
2243 default-toolbar, top-toolbar, bottom-toolbar, left-toolbar, right-toolbar,
2244 default-toolbar-height, default-toolbar-width, top-toolbar-height,
2245 bottom-toolbar-height, left-toolbar-width, right-toolbar-width,
2246 default-toolbar-visible-p, top-toolbar-visible-p, bottom-toolbar-visible-p,
2247 left-toolbar-visible-p, right-toolbar-visible-p, toolbar-buttons-captioned-p,
2248 top-toolbar-border-width, bottom-toolbar-border-width,
2249 left-toolbar-border-width, right-toolbar-border-width,
2250 modeline-shadow-thickness, has-modeline-p
2251 [Giving the name of any built-in specifier variable is
2252 equivalent to calling `set-specifier' on the specifier,
2253 with a locale of FRAME. Giving the name to `frame-property'
2254 calls `specifier-instance' on the specifier.]
2256 text-pointer-glyph, nontext-pointer-glyph, modeline-pointer-glyph,
2257 selection-pointer-glyph, busy-pointer-glyph, toolbar-pointer-glyph,
2258 menubar-pointer-glyph, scrollbar-pointer-glyph, gc-pointer-glyph,
2259 octal-escape-glyph, control-arrow-glyph, invisible-text-glyph,
2260 hscroll-glyph, truncation-glyph, continuation-glyph
2261 [Giving the name of any glyph variable is equivalent to
2262 calling `set-glyph-image' on the glyph, with a locale
2263 of FRAME. Giving the name to `frame-property' calls
2264 `glyph-image-instance' on the glyph.]
2266 [default foreground], [default background], [default font],
2267 [modeline foreground], [modeline background], [modeline font],
2269 [Giving a vector of a face and a property is equivalent
2270 to calling `set-face-property' on the face and property,
2271 with a locale of FRAME. Giving the vector to
2272 `frame-property' calls `face-property-instance' on the
2275 Finally, if a frame property symbol has the property `frame-property-alias'
2276 on it, then the value will be used in place of that symbol when looking
2277 up and setting frame property values. This allows you to alias one
2278 frame property name to another.
2280 See the variables `default-x-frame-plist', `default-tty-frame-plist'
2281 and `default-mswindows-frame-plist' for a description of the properties
2282 recognized for particular types of frames.
2286 struct frame *f = decode_frame (frame);
2289 struct gcpro gcpro1, gcpro2;
2291 XSETFRAME (frame, f);
2292 GCPRO2 (frame, plist);
2293 Fcheck_valid_plist (plist);
2294 plist = Fcopy_sequence (plist);
2295 Fcanonicalize_lax_plist (plist, Qnil);
2296 for (tail = plist; !NILP (tail); tail = Fcdr (Fcdr (tail)))
2298 Lisp_Object prop = Fcar (tail);
2299 Lisp_Object val = Fcar (Fcdr (tail));
2301 prop = get_property_alias (prop);
2304 /* mly wants this, but it's not reasonable to change the name of a
2305 frame after it has been created, because the old name was used
2306 for resource lookup. */
2307 if (EQ (prop, Qname))
2313 if (EQ (prop, Qminibuffer))
2314 store_minibuf_frame_prop (f, val);
2315 if (EQ (prop, Qunsplittable))
2316 f->no_split = !NILP (val);
2317 if (EQ (prop, Qbuffer_predicate))
2318 f->buffer_predicate = val;
2319 if (SYMBOLP (prop) && EQ (Fbuilt_in_variable_type (prop),
2321 call3 (Qset_specifier, Fsymbol_value (prop), val, frame);
2322 if (SYMBOLP (prop) && !NILP (Fget (prop, Qconst_glyph_variable, Qnil)))
2323 call3 (Qset_glyph_image, Fsymbol_value (prop), val, frame);
2324 if (VECTORP (prop) && XVECTOR_LENGTH (prop) == 2)
2326 Lisp_Object face_prop = XVECTOR_DATA (prop)[1];
2327 CHECK_SYMBOL (face_prop);
2328 call4 (Qset_face_property,
2329 Fget_face (XVECTOR_DATA (prop)[0]),
2330 face_prop, val, frame);
2334 MAYBE_FRAMEMETH (f, set_frame_properties, (f, plist));
2335 for (tailp = &plist; !NILP (*tailp);)
2337 Lisp_Object *next_tailp;
2341 next = Fcdr (*tailp);
2343 next_tailp = &XCDR (next);
2344 prop = Fcar (*tailp);
2346 prop = get_property_alias (prop);
2348 if (EQ (prop, Qminibuffer)
2349 || EQ (prop, Qunsplittable)
2350 || EQ (prop, Qbuffer_predicate)
2351 || EQ (prop, Qheight)
2352 || EQ (prop, Qwidth)
2353 || (SYMBOLP (prop) && EQ (Fbuilt_in_variable_type (prop),
2355 || (SYMBOLP (prop) && !NILP (Fget (prop, Qconst_glyph_variable,
2357 || (VECTORP (prop) && XVECTOR_LENGTH (prop) == 2)
2358 || FRAMEMETH_OR_GIVEN (f, internal_frame_property_p, (f, prop), 0))
2359 *tailp = *next_tailp;
2363 f->plist = nconc2 (plist, f->plist);
2364 Fcanonicalize_lax_plist (f->plist, Qnil);
2369 DEFUN ("frame-property", Fframe_property, 2, 3, 0, /*
2370 Return FRAME's value for property PROPERTY.
2371 See `set-frame-properties' for the built-in property names.
2373 (frame, property, default_))
2375 struct frame *f = decode_frame (frame);
2378 XSETFRAME (frame, f);
2380 property = get_property_alias (property);
2382 if (EQ (Qname, property)) return f->name;
2384 if (EQ (Qheight, property) || EQ (Qwidth, property))
2386 if (window_system_pixelated_geometry (frame))
2389 pixel_to_real_char_size (f, FRAME_PIXWIDTH (f), FRAME_PIXHEIGHT (f),
2391 return make_int (EQ (Qheight, property) ? height: width);
2394 return make_int (EQ (Qheight, property) ?
2399 /* NOTE: FSF returns Qnil instead of Qt for FRAME_HAS_MINIBUF_P.
2400 This is over-the-top bogosity, because it's inconsistent with
2401 the semantics of `minibuffer' when passed to `make-frame'.
2402 Returning Qt makes things consistent. */
2403 if (EQ (Qminibuffer, property))
2404 return (FRAME_MINIBUF_ONLY_P (f) ? Qonly :
2405 FRAME_HAS_MINIBUF_P (f) ? Qt :
2406 FRAME_MINIBUF_WINDOW (f));
2407 if (EQ (Qunsplittable, property))
2408 return FRAME_NO_SPLIT_P (f) ? Qt : Qnil;
2409 if (EQ (Qbuffer_predicate, property))
2410 return f->buffer_predicate;
2412 if (SYMBOLP (property))
2414 if (EQ (Fbuilt_in_variable_type (property), Qconst_specifier))
2415 return Fspecifier_instance (Fsymbol_value (property),
2416 frame, default_, Qnil);
2417 if (!NILP (Fget (property, Qconst_glyph_variable, Qnil)))
2419 Lisp_Object glyph = Fsymbol_value (property);
2420 CHECK_GLYPH (glyph);
2421 return Fspecifier_instance (XGLYPH_IMAGE (glyph),
2422 frame, default_, Qnil);
2426 if (VECTORP (property) && XVECTOR_LENGTH (property) == 2)
2428 Lisp_Object face_prop = XVECTOR_DATA (property)[1];
2429 CHECK_SYMBOL (face_prop);
2430 return call3 (Qface_property_instance,
2431 Fget_face (XVECTOR_DATA (property)[0]),
2435 if (HAS_FRAMEMETH_P (f, frame_property))
2436 if (!UNBOUNDP (value = FRAMEMETH (f, frame_property, (f, property))))
2439 if (!UNBOUNDP (value = external_plist_get (&f->plist, property, 1, ERROR_ME)))
2445 DEFUN ("frame-properties", Fframe_properties, 0, 1, 0, /*
2446 Return a property list of the properties of FRAME.
2447 Do not modify this list; use `set-frame-property' instead.
2451 struct frame *f = decode_frame (frame);
2452 Lisp_Object result = Qnil;
2453 struct gcpro gcpro1;
2457 XSETFRAME (frame, f);
2459 /* #### for the moment (since old code uses `frame-parameters'),
2460 we call `copy-sequence' on f->plist. That allows frame-parameters
2461 to destructively convert the plist into an alist, which is more
2462 efficient than doing it non-destructively. At some point we
2463 should remove the call to copy-sequence. */
2464 result = Fcopy_sequence (f->plist);
2466 /* #### should we be adding all the specifiers and glyphs?
2467 That would entail having a list of them all. */
2468 if (HAS_FRAMEMETH_P (f, frame_properties))
2469 result = nconc2 (FRAMEMETH (f, frame_properties, (f)), result);
2471 if (!NILP (f->buffer_predicate))
2472 result = cons3 (Qbuffer_predicate, f->buffer_predicate, result);
2474 if (FRAME_NO_SPLIT_P (f))
2475 result = cons3 (Qunsplittable, Qt, result);
2477 /* NOTE: FSF returns Qnil instead of Qt for FRAME_HAS_MINIBUF_P.
2478 This is over-the-top bogosity, because it's inconsistent with
2479 the semantics of `minibuffer' when passed to `make-frame'.
2480 Returning Qt makes things consistent. */
2481 result = cons3 (Qminibuffer,
2482 (FRAME_MINIBUF_ONLY_P (f) ? Qonly :
2483 FRAME_HAS_MINIBUF_P (f) ? Qt :
2484 FRAME_MINIBUF_WINDOW (f)),
2489 if (window_system_pixelated_geometry (frame))
2491 pixel_to_real_char_size (f, FRAME_PIXWIDTH (f), FRAME_PIXHEIGHT (f),
2496 height = FRAME_HEIGHT (f);
2497 width = FRAME_WIDTH (f);
2499 result = cons3 (Qwidth , make_int (width), result);
2500 result = cons3 (Qheight, make_int (height), result);
2503 result = cons3 (Qname, f->name, result);
2510 DEFUN ("frame-pixel-height", Fframe_pixel_height, 0, 1, 0, /*
2511 Return the height in pixels of FRAME.
2515 return make_int (decode_frame (frame)->pixheight);
2518 DEFUN ("frame-pixel-width", Fframe_pixel_width, 0, 1, 0, /*
2519 Return the width in pixels of FRAME.
2523 return make_int (decode_frame (frame)->pixwidth);
2526 DEFUN ("frame-name", Fframe_name, 0, 1, 0, /*
2527 Return the name of FRAME (defaulting to the selected frame).
2528 This is not the same as the `title' of the frame.
2532 return decode_frame (frame)->name;
2535 DEFUN ("frame-modified-tick", Fframe_modified_tick, 0, 1, 0, /*
2536 Return FRAME's tick counter, incremented for each change to the frame.
2537 Each frame has a tick counter which is incremented each time the frame
2538 is resized, a window is resized, added, or deleted, a face is changed,
2539 `set-window-buffer' or `select-window' is called on a window in the
2540 frame, the window-start of a window in the frame has changed, or
2541 anything else interesting has happened. It wraps around occasionally.
2542 No argument or nil as argument means use selected frame as FRAME.
2546 return make_int (decode_frame (frame)->modiff);
2550 internal_set_frame_size (struct frame *f, int cols, int rows, int pretend)
2552 /* An explicit size change cancels any pending frame size adjustment */
2553 CLEAR_FRAME_SIZE_SLIPPED(f);
2555 if (pretend || !HAS_FRAMEMETH_P (f, set_frame_size))
2556 change_frame_size (f, rows, cols, 0);
2558 FRAMEMETH (f, set_frame_size, (f, cols, rows));
2561 DEFUN ("set-frame-height", Fset_frame_height, 2, 3, 0, /*
2562 Specify that the frame FRAME has LINES lines.
2563 Optional third arg non-nil means that redisplay should use LINES lines
2564 but that the idea of the actual height of the frame should not be changed.
2566 (frame, rows, pretend))
2568 struct frame *f = decode_frame (frame);
2570 XSETFRAME (frame, f);
2573 if (window_system_pixelated_geometry (frame))
2575 char_to_real_pixel_size (f, 0, XINT (rows), 0, &height);
2576 width = FRAME_PIXWIDTH (f);
2580 height = XINT (rows);
2581 width = FRAME_WIDTH (f);
2584 internal_set_frame_size (f, width, height, !NILP (pretend));
2588 DEFUN ("set-frame-width", Fset_frame_width, 2, 3, 0, /*
2589 Specify that the frame FRAME has COLS columns.
2590 Optional third arg non-nil means that redisplay should use COLS columns
2591 but that the idea of the actual width of the frame should not be changed.
2593 (frame, cols, pretend))
2595 struct frame *f = decode_frame (frame);
2597 XSETFRAME (frame, f);
2600 if (window_system_pixelated_geometry (frame))
2602 char_to_real_pixel_size (f, XINT (cols), 0, &width, 0);
2603 height = FRAME_PIXHEIGHT (f);
2607 width = XINT (cols);
2608 height = FRAME_HEIGHT (f);
2611 internal_set_frame_size (f, width, height, !NILP (pretend));
2615 DEFUN ("set-frame-size", Fset_frame_size, 3, 4, 0, /*
2616 Set the size of FRAME to COLS by ROWS.
2617 Optional fourth arg non-nil means that redisplay should use COLS by ROWS
2618 but that the idea of the actual size of the frame should not be changed.
2620 (frame, cols, rows, pretend))
2622 struct frame *f = decode_frame (frame);
2624 XSETFRAME (frame, f);
2628 if (window_system_pixelated_geometry (frame))
2629 char_to_real_pixel_size (f, XINT (cols), XINT (rows), &width, &height);
2632 height = XINT (rows);
2633 width = XINT (cols);
2636 internal_set_frame_size (f, width, height, !NILP (pretend));
2640 DEFUN ("set-frame-position", Fset_frame_position, 3, 3, 0, /*
2641 Set position of FRAME in pixels to XOFFSET by YOFFSET.
2642 This is actually the position of the upper left corner of the frame.
2643 Negative values for XOFFSET or YOFFSET are interpreted relative to
2644 the rightmost or bottommost possible position (that stays within the screen).
2646 (frame, xoffset, yoffset))
2648 struct frame *f = decode_frame (frame);
2649 CHECK_INT (xoffset);
2650 CHECK_INT (yoffset);
2652 MAYBE_FRAMEMETH (f, set_frame_position, (f, XINT (xoffset), XINT (yoffset)));
2659 /* Frame size conversion functions moved here from EmacsFrame.c
2660 because they're generic and really don't belong in that file.
2661 Function get_default_char_pixel_size() removed because it's
2662 exactly the same as default_face_height_and_width(). */
2664 frame_conversion_internal (struct frame *f, int pixel_to_char,
2665 int *pixel_width, int *pixel_height,
2666 int *char_width, int *char_height,
2673 Lisp_Object frame, window;
2675 XSETFRAME (frame, f);
2677 default_face_height_and_width (frame, &cph, &cpw);
2679 default_face_height_and_width_1 (frame, &cph, &cpw);
2681 window = FRAME_SELECTED_WINDOW (f);
2683 egw = max (glyph_width (Vcontinuation_glyph, window),
2684 glyph_width (Vtruncation_glyph, window));
2685 egw = max (egw, cpw);
2686 bdr = 2 * f->internal_border_width;
2687 obw = FRAME_SCROLLBAR_WIDTH (f) + FRAME_THEORETICAL_LEFT_TOOLBAR_WIDTH (f) +
2688 FRAME_THEORETICAL_RIGHT_TOOLBAR_WIDTH (f) +
2689 2 * FRAME_THEORETICAL_LEFT_TOOLBAR_BORDER_WIDTH (f) +
2690 2 * FRAME_THEORETICAL_RIGHT_TOOLBAR_BORDER_WIDTH (f);
2691 obh = FRAME_SCROLLBAR_HEIGHT (f) + FRAME_THEORETICAL_TOP_TOOLBAR_HEIGHT (f) +
2692 FRAME_THEORETICAL_BOTTOM_TOOLBAR_HEIGHT (f) +
2693 2 * FRAME_THEORETICAL_TOP_TOOLBAR_BORDER_WIDTH (f) +
2694 2 * FRAME_THEORETICAL_BOTTOM_TOOLBAR_BORDER_WIDTH (f);
2699 *char_width = 1 + ((*pixel_width - egw) - bdr - obw) / cpw;
2701 *char_height = (*pixel_height - bdr - obh) / cph;
2706 *pixel_width = (*char_width - 1) * cpw + egw + bdr + obw;
2708 *pixel_height = *char_height * cph + bdr + obh;
2712 /* This takes the size in pixels of the text area, and returns the number
2713 of characters that will fit there, taking into account the internal
2714 border width, and the pixel width of the line terminator glyphs (which
2715 always count as one "character" wide, even if they are not the same size
2716 as the default character size of the default font). The frame scrollbar
2717 width and left and right toolbar widths are also subtracted out of the
2718 available width. The frame scrollbar height and top and bottom toolbar
2719 heights are subtracted out of the available height.
2721 Therefore the result is not necessarily a multiple of anything in
2724 pixel_to_char_size (struct frame *f, int pixel_width, int pixel_height,
2725 int *char_width, int *char_height)
2727 frame_conversion_internal (f, 1, &pixel_width, &pixel_height, char_width,
2731 /* Given a character size, this returns the minimum number of pixels
2732 necessary to display that many characters, taking into account the
2733 internal border width, scrollbar height and width, toolbar heights and
2734 widths and the size of the line terminator glyphs (assuming the line
2735 terminators take up exactly one character position).
2737 Therefore the result is not necessarily a multiple of anything in
2740 char_to_pixel_size (struct frame *f, int char_width, int char_height,
2741 int *pixel_width, int *pixel_height)
2743 frame_conversion_internal (f, 0, pixel_width, pixel_height, &char_width,
2747 /* Given a pixel size, rounds DOWN to the smallest size in pixels necessary
2748 to display the same number of characters as are displayable now.
2751 round_size_to_char (struct frame *f, int in_width, int in_height,
2752 int *out_width, int *out_height)
2756 pixel_to_char_size (f, in_width, in_height, &char_width, &char_height);
2757 char_to_pixel_size (f, char_width, char_height, out_width, out_height);
2760 /* Versions of the above which always account for real font metrics.
2763 pixel_to_real_char_size (struct frame *f, int pixel_width, int pixel_height,
2764 int *char_width, int *char_height)
2766 frame_conversion_internal (f, 1, &pixel_width, &pixel_height, char_width,
2771 char_to_real_pixel_size (struct frame *f, int char_width, int char_height,
2772 int *pixel_width, int *pixel_height)
2774 frame_conversion_internal (f, 0, pixel_width, pixel_height, &char_width,
2779 round_size_to_real_char (struct frame *f, int in_width, int in_height,
2780 int *out_width, int *out_height)
2784 pixel_to_real_char_size (f, in_width, in_height, &char_width, &char_height);
2785 char_to_real_pixel_size (f, char_width, char_height, out_width, out_height);
2788 /* Change the frame height and/or width. Values may be given as zero to
2789 indicate no change is to take place. */
2791 change_frame_size_1 (struct frame *f, int newheight, int newwidth)
2794 int new_pixheight, new_pixwidth;
2795 int font_height, real_font_height, font_width;
2797 /* #### Chuck -- shouldn't we be checking to see if the frame
2798 is being "changed" to its existing size, and do nothing if so? */
2799 /* No, because it would hose toolbar updates. The toolbar
2800 update code relies on this function to cause window `top' and
2801 `left' coordinates to be recomputed even though no frame size
2802 change occurs. --kyle */
2806 XSETFRAME (frame, f);
2808 default_face_height_and_width (frame, &real_font_height, 0);
2809 default_face_height_and_width_1 (frame, &font_height, &font_width);
2811 /* This size-change overrides any pending one for this frame. */
2812 FRAME_NEW_HEIGHT (f) = 0;
2813 FRAME_NEW_WIDTH (f) = 0;
2815 new_pixheight = newheight * font_height;
2816 new_pixwidth = (newwidth - 1) * font_width;
2818 /* #### dependency on FRAME_WIN_P should be removed. */
2819 if (FRAME_WIN_P (f))
2821 new_pixheight += FRAME_SCROLLBAR_HEIGHT (f);
2822 new_pixwidth += FRAME_SCROLLBAR_WIDTH (f);
2825 /* when frame_conversion_internal() calculated the number of rows/cols
2826 in the frame, the theoretical toolbar sizes were subtracted out.
2827 The calculations below adjust for real toolbar height/width in
2828 frame, which may be different from frame spec, taking the above
2829 fact into account */
2831 + FRAME_THEORETICAL_TOP_TOOLBAR_HEIGHT (f)
2832 + 2 * FRAME_THEORETICAL_TOP_TOOLBAR_BORDER_WIDTH (f)
2833 - FRAME_REAL_TOP_TOOLBAR_HEIGHT (f)
2834 - 2 * FRAME_REAL_TOP_TOOLBAR_BORDER_WIDTH (f);
2837 + FRAME_THEORETICAL_BOTTOM_TOOLBAR_HEIGHT (f)
2838 + 2 * FRAME_THEORETICAL_BOTTOM_TOOLBAR_BORDER_WIDTH (f)
2839 - FRAME_REAL_BOTTOM_TOOLBAR_HEIGHT (f)
2840 - 2 * FRAME_REAL_BOTTOM_TOOLBAR_BORDER_WIDTH (f);
2843 + FRAME_THEORETICAL_LEFT_TOOLBAR_WIDTH (f)
2844 + 2 * FRAME_THEORETICAL_LEFT_TOOLBAR_BORDER_WIDTH (f)
2845 - FRAME_REAL_LEFT_TOOLBAR_WIDTH (f)
2846 - 2 * FRAME_REAL_LEFT_TOOLBAR_BORDER_WIDTH (f);
2849 + FRAME_THEORETICAL_RIGHT_TOOLBAR_WIDTH (f)
2850 + 2 * FRAME_THEORETICAL_RIGHT_TOOLBAR_BORDER_WIDTH (f)
2851 - FRAME_REAL_RIGHT_TOOLBAR_WIDTH (f)
2852 - 2 * FRAME_REAL_RIGHT_TOOLBAR_BORDER_WIDTH (f);
2854 new_pixwidth += 2 * f->internal_border_width;
2856 /* Adjust the width for the end glyph which may be a different width
2857 than the default character width. */
2859 int adjustment, trunc_width, cont_width;
2861 trunc_width = glyph_width (Vtruncation_glyph,
2862 FRAME_SELECTED_WINDOW (f));
2863 cont_width = glyph_width (Vcontinuation_glyph,
2864 FRAME_SELECTED_WINDOW (f));
2865 adjustment = max (trunc_width, cont_width);
2866 adjustment = max (adjustment, font_width);
2868 new_pixwidth += adjustment;
2871 /* If we don't have valid values, exit. */
2872 if (!new_pixheight && !new_pixwidth)
2877 XWINDOW (FRAME_ROOT_WINDOW (f))->pixel_top = FRAME_TOP_BORDER_END (f);
2879 if (FRAME_HAS_MINIBUF_P (f)
2880 && ! FRAME_MINIBUF_ONLY_P (f))
2881 /* Frame has both root and minibuffer. */
2884 * Leave the minibuffer height the same if the frame has
2885 * been initialized, and the minibuffer height is tall
2886 * enough to display at least one line of text in the default
2887 * font, and the old minibuffer height is a multiple of the
2888 * default font height. This should cause the minibuffer
2889 * height to be recomputed on font changes but not for
2890 * other frame size changes, which seems reasonable.
2892 int old_minibuf_height =
2893 XWINDOW(FRAME_MINIBUF_WINDOW(f))->pixel_height;
2894 int minibuf_height =
2895 f->init_finished && (old_minibuf_height % real_font_height) == 0 ?
2896 max(old_minibuf_height, real_font_height) :
2898 set_window_pixheight (FRAME_ROOT_WINDOW (f),
2899 /* - font_height for minibuffer */
2900 new_pixheight - minibuf_height, 0);
2902 XWINDOW (FRAME_MINIBUF_WINDOW (f))->pixel_top =
2903 new_pixheight - minibuf_height + FRAME_TOP_BORDER_END (f);
2905 set_window_pixheight (FRAME_MINIBUF_WINDOW (f), minibuf_height, 0);
2908 /* Frame has just one top-level window. */
2909 set_window_pixheight (FRAME_ROOT_WINDOW (f), new_pixheight, 0);
2911 FRAME_HEIGHT (f) = newheight;
2912 if (FRAME_TTY_P (f))
2913 f->pixheight = newheight;
2918 XWINDOW (FRAME_ROOT_WINDOW (f))->pixel_left = FRAME_LEFT_BORDER_END (f);
2919 set_window_pixwidth (FRAME_ROOT_WINDOW (f), new_pixwidth, 0);
2921 if (FRAME_HAS_MINIBUF_P (f))
2923 XWINDOW (FRAME_MINIBUF_WINDOW (f))->pixel_left =
2924 FRAME_LEFT_BORDER_END (f);
2925 set_window_pixwidth (FRAME_MINIBUF_WINDOW (f), new_pixwidth, 0);
2928 FRAME_WIDTH (f) = newwidth;
2929 if (FRAME_TTY_P (f))
2930 f->pixwidth = newwidth;
2933 if (window_system_pixelated_geometry (frame))
2934 pixel_to_real_char_size (f, FRAME_PIXWIDTH (f), FRAME_PIXHEIGHT (f),
2935 &FRAME_CHARWIDTH (f), &FRAME_CHARHEIGHT (f));
2938 FRAME_CHARWIDTH (f) = FRAME_WIDTH (f);
2939 FRAME_CHARHEIGHT (f) = FRAME_HEIGHT (f);
2942 MARK_FRAME_TOOLBARS_CHANGED (f);
2943 MARK_FRAME_CHANGED (f);
2944 f->echo_area_garbaged = 1;
2948 change_frame_size (struct frame *f, int newheight, int newwidth, int delay)
2950 /* sometimes we get passed a size that's too small (esp. when a
2951 client widget gets resized, since we have no control over this).
2953 check_frame_size (f, &newheight, &newwidth);
2955 if (delay || in_display || gc_in_progress)
2957 MARK_FRAME_SIZE_CHANGED (f);
2958 f->new_width = newwidth;
2959 f->new_height = newheight;
2963 f->size_change_pending = 0;
2964 /* For TTY frames, it's like one, like all ...
2965 Can't have two TTY frames of different sizes on the same device. */
2966 if (FRAME_TTY_P (f))
2968 Lisp_Object frmcons;
2970 DEVICE_FRAME_LOOP (frmcons, XDEVICE (FRAME_DEVICE (f)))
2971 change_frame_size_1 (XFRAME (XCAR (frmcons)), newheight, newwidth);
2974 change_frame_size_1 (f, newheight, newwidth);
2978 /* The caller is responsible for freeing the returned string. */
2980 generate_title_string (struct window *w, Lisp_Object format_str,
2981 face_index findex, int type)
2983 struct display_line *dl;
2984 struct display_block *db;
2987 dl = &title_string_display_line;
2988 db = get_display_block_from_line (dl, TEXT);
2989 Dynarr_reset (db->runes);
2991 generate_formatted_string_db (format_str, Qnil, w, dl, db, findex, 0,
2994 Dynarr_reset (title_string_emchar_dynarr);
2995 while (elt < Dynarr_length (db->runes))
2997 if (Dynarr_atp (db->runes, elt)->type == RUNE_CHAR)
2998 Dynarr_add (title_string_emchar_dynarr,
2999 Dynarr_atp (db->runes, elt)->object.chr.ch);
3004 convert_emchar_string_into_malloced_string
3005 (Dynarr_atp (title_string_emchar_dynarr, 0),
3006 Dynarr_length (title_string_emchar_dynarr), 0);
3010 update_frame_title (struct frame *f)
3012 struct window *w = XWINDOW (FRAME_SELECTED_WINDOW (f));
3013 Lisp_Object title_format;
3014 Lisp_Object icon_format;
3017 /* We don't change the title for the minibuffer unless the frame
3018 only has a minibuffer. */
3019 if (MINI_WINDOW_P (w) && !FRAME_MINIBUF_ONLY_P (f))
3022 /* And we don't want dead buffers to blow up on us. */
3023 if (!BUFFER_LIVE_P (XBUFFER (w->buffer)))
3027 title_format = symbol_value_in_buffer (Qframe_title_format, w->buffer);
3028 icon_format = symbol_value_in_buffer (Qframe_icon_title_format, w->buffer);
3030 if (HAS_FRAMEMETH_P (f, set_title_from_bufbyte))
3032 title = generate_title_string (w, title_format,
3033 DEFAULT_INDEX, CURRENT_DISP);
3034 FRAMEMETH (f, set_title_from_bufbyte, (f, title));
3037 if (HAS_FRAMEMETH_P (f, set_icon_name_from_bufbyte))
3039 if (!EQ (icon_format, title_format) || !title)
3044 title = generate_title_string (w, icon_format,
3045 DEFAULT_INDEX, CURRENT_DISP);
3047 FRAMEMETH (f, set_icon_name_from_bufbyte, (f, title));
3055 DEFUN ("set-frame-pointer", Fset_frame_pointer, 2, 2, 0, /*
3056 Set the mouse pointer of FRAME to the given pointer image instance.
3057 You should not call this function directly. Instead, set one of
3058 the variables `text-pointer-glyph', `nontext-pointer-glyph',
3059 `modeline-pointer-glyph', `selection-pointer-glyph',
3060 `busy-pointer-glyph', or `toolbar-pointer-glyph'.
3062 (frame, image_instance))
3064 struct frame *f = decode_frame (frame);
3065 CHECK_POINTER_IMAGE_INSTANCE (image_instance);
3066 if (!EQ (f->pointer, image_instance))
3068 f->pointer = image_instance;
3069 MAYBE_FRAMEMETH (f, set_frame_pointer, (f));
3076 update_frame_icon (struct frame *f)
3078 if (f->icon_changed || f->windows_changed)
3081 Lisp_Object new_icon;
3083 XSETFRAME (frame, f);
3084 new_icon = glyph_image_instance (Vframe_icon_glyph, frame,
3086 if (!EQ (new_icon, f->icon))
3089 MAYBE_FRAMEMETH (f, set_frame_icon, (f));
3093 f->icon_changed = 0;
3097 icon_glyph_changed (Lisp_Object glyph, Lisp_Object property,
3104 /***************************************************************************/
3106 /* initialization */
3108 /***************************************************************************/
3117 title_string_emchar_dynarr = Dynarr_new (Emchar);
3118 xzero (title_string_display_line);
3123 syms_of_frame (void)
3125 defsymbol (&Qdelete_frame_hook, "delete-frame-hook");
3126 defsymbol (&Qselect_frame_hook, "select-frame-hook");
3127 defsymbol (&Qdeselect_frame_hook, "deselect-frame-hook");
3128 defsymbol (&Qcreate_frame_hook, "create-frame-hook");
3129 defsymbol (&Qcustom_initialize_frame, "custom-initialize-frame");
3130 defsymbol (&Qmouse_enter_frame_hook, "mouse-enter-frame-hook");
3131 defsymbol (&Qmouse_leave_frame_hook, "mouse-leave-frame-hook");
3132 defsymbol (&Qmap_frame_hook, "map-frame-hook");
3133 defsymbol (&Qunmap_frame_hook, "unmap-frame-hook");
3135 defsymbol (&Qframep, "framep");
3136 defsymbol (&Qframe_live_p, "frame-live-p");
3137 defsymbol (&Qdelete_frame, "delete-frame");
3138 defsymbol (&Qsynchronize_minibuffers, "synchronize-minibuffers");
3139 defsymbol (&Qbuffer_predicate, "buffer-predicate");
3140 defsymbol (&Qframe_being_created, "frame-being-created");
3141 defsymbol (&Qmake_initial_minibuffer_frame, "make-initial-minibuffer-frame");
3143 defsymbol (&Qframe_title_format, "frame-title-format");
3144 defsymbol (&Qframe_icon_title_format, "frame-icon-title-format");
3146 defsymbol (&Qhidden, "hidden");
3147 defsymbol (&Qvisible, "visible");
3148 defsymbol (&Qiconic, "iconic");
3149 defsymbol (&Qinvisible, "invisible");
3150 defsymbol (&Qvisible_iconic, "visible-iconic");
3151 defsymbol (&Qinvisible_iconic, "invisible-iconic");
3152 defsymbol (&Qnomini, "nomini");
3153 defsymbol (&Qvisible_nomini, "visible-nomini");
3154 defsymbol (&Qiconic_nomini, "iconic-nomini");
3155 defsymbol (&Qinvisible_nomini, "invisible-nomini");
3156 defsymbol (&Qvisible_iconic_nomini, "visible-iconic-nomini");
3157 defsymbol (&Qinvisible_iconic_nomini, "invisible-iconic-nomini");
3159 defsymbol (&Qminibuffer, "minibuffer");
3160 defsymbol (&Qunsplittable, "unsplittable");
3161 defsymbol (&Qinternal_border_width, "internal-border-width");
3162 defsymbol (&Qtop_toolbar_shadow_color, "top-toolbar-shadow-color");
3163 defsymbol (&Qbottom_toolbar_shadow_color, "bottom-toolbar-shadow-color");
3164 defsymbol (&Qbackground_toolbar_color, "background-toolbar-color");
3165 defsymbol (&Qtop_toolbar_shadow_pixmap, "top-toolbar-shadow-pixmap");
3166 defsymbol (&Qbottom_toolbar_shadow_pixmap, "bottom-toolbar-shadow-pixmap");
3167 defsymbol (&Qtoolbar_shadow_thickness, "toolbar-shadow-thickness");
3168 defsymbol (&Qscrollbar_placement, "scrollbar-placement");
3169 defsymbol (&Qinter_line_space, "inter-line-space");
3170 /* Qiconic already in this function. */
3171 defsymbol (&Qvisual_bell, "visual-bell");
3172 defsymbol (&Qbell_volume, "bell-volume");
3173 defsymbol (&Qpointer_background, "pointer-background");
3174 defsymbol (&Qpointer_color, "pointer-color");
3175 defsymbol (&Qtext_pointer, "text-pointer");
3176 defsymbol (&Qspace_pointer, "space-pointer");
3177 defsymbol (&Qmodeline_pointer, "modeline-pointer");
3178 defsymbol (&Qgc_pointer, "gc-pointer");
3179 defsymbol (&Qinitially_unmapped, "initially-unmapped");
3180 defsymbol (&Quse_backing_store, "use-backing-store");
3181 defsymbol (&Qborder_color, "border-color");
3182 defsymbol (&Qborder_width, "border-width");
3183 /* Qwidth, Qheight, Qleft, Qtop in general.c */
3184 defsymbol (&Qset_specifier, "set-specifier");
3185 defsymbol (&Qset_glyph_image, "set-glyph-image");
3186 defsymbol (&Qset_face_property, "set-face-property");
3187 defsymbol (&Qface_property_instance, "face-property-instance");
3188 defsymbol (&Qframe_property_alias, "frame-property-alias");
3190 DEFSUBR (Fmake_frame);
3192 DEFSUBR (Fframe_live_p);
3194 DEFSUBR (Fignore_event);
3196 DEFSUBR (Ffocus_frame);
3197 DEFSUBR (Fselect_frame);
3198 DEFSUBR (Fselected_frame);
3199 DEFSUBR (Factive_minibuffer_window);
3200 DEFSUBR (Flast_nonminibuf_frame);
3201 DEFSUBR (Fframe_root_window);
3202 DEFSUBR (Fframe_selected_window);
3203 DEFSUBR (Fset_frame_selected_window);
3204 DEFSUBR (Fframe_device);
3205 DEFSUBR (Fnext_frame);
3206 DEFSUBR (Fprevious_frame);
3207 DEFSUBR (Fdelete_frame);
3208 DEFSUBR (Fmouse_position);
3209 DEFSUBR (Fmouse_pixel_position);
3210 DEFSUBR (Fmouse_position_as_motion_event);
3211 DEFSUBR (Fset_mouse_position);
3212 DEFSUBR (Fset_mouse_pixel_position);
3213 DEFSUBR (Fmake_frame_visible);
3214 DEFSUBR (Fmake_frame_invisible);
3215 DEFSUBR (Ficonify_frame);
3216 DEFSUBR (Fdeiconify_frame);
3217 DEFSUBR (Fframe_visible_p);
3218 DEFSUBR (Fframe_totally_visible_p);
3219 DEFSUBR (Fframe_iconified_p);
3220 DEFSUBR (Fvisible_frame_list);
3221 DEFSUBR (Fraise_frame);
3222 DEFSUBR (Flower_frame);
3223 DEFSUBR (Fframe_property);
3224 DEFSUBR (Fframe_properties);
3225 DEFSUBR (Fset_frame_properties);
3226 DEFSUBR (Fframe_pixel_height);
3227 DEFSUBR (Fframe_pixel_width);
3228 DEFSUBR (Fframe_name);
3229 DEFSUBR (Fframe_modified_tick);
3230 DEFSUBR (Fset_frame_height);
3231 DEFSUBR (Fset_frame_width);
3232 DEFSUBR (Fset_frame_size);
3233 DEFSUBR (Fset_frame_position);
3234 DEFSUBR (Fset_frame_pointer);
3238 vars_of_frame (void)
3241 Vframe_being_created = Qnil;
3242 staticpro (&Vframe_being_created);
3245 Fprovide (intern ("cde"));
3248 #ifdef HAVE_OFFIX_DND
3249 Fprovide (intern ("offix"));
3252 #if 0 /* FSFmacs stupidity */
3253 xxDEFVAR_LISP ("emacs-iconified", &Vemacs_iconified /*
3254 Non-nil if all of emacs is iconified and frame updates are not needed.
3256 Vemacs_iconified = Qnil;
3259 DEFVAR_LISP ("select-frame-hook", &Vselect_frame_hook /*
3260 Function or functions to run just after a new frame is given the focus.
3261 Note that calling `select-frame' does not necessarily set the focus:
3262 The actual window-system focus will not be changed until the next time
3263 that XEmacs is waiting for an event, and even then, the window manager
3264 may refuse the focus-change request.
3266 Vselect_frame_hook = Qnil;
3268 DEFVAR_LISP ("deselect-frame-hook", &Vdeselect_frame_hook /*
3269 Function or functions to run just before a frame loses the focus.
3270 See `select-frame-hook'.
3272 Vdeselect_frame_hook = Qnil;
3274 DEFVAR_LISP ("delete-frame-hook", &Vdelete_frame_hook /*
3275 Function or functions to call when a frame is deleted.
3276 One argument, the about-to-be-deleted frame.
3278 Vdelete_frame_hook = Qnil;
3280 DEFVAR_LISP ("create-frame-hook", &Vcreate_frame_hook /*
3281 Function or functions to call when a frame is created.
3282 One argument, the newly-created frame.
3284 Vcreate_frame_hook = Qnil;
3286 DEFVAR_LISP ("mouse-enter-frame-hook", &Vmouse_enter_frame_hook /*
3287 Function or functions to call when the mouse enters a frame.
3288 One argument, the frame.
3289 Be careful not to make assumptions about the window manager's focus model.
3290 In most cases, the `deselect-frame-hook' is more appropriate.
3292 Vmouse_enter_frame_hook = Qnil;
3294 DEFVAR_LISP ("mouse-leave-frame-hook", &Vmouse_leave_frame_hook /*
3295 Function or functions to call when the mouse leaves a frame.
3296 One argument, the frame.
3297 Be careful not to make assumptions about the window manager's focus model.
3298 In most cases, the `select-frame-hook' is more appropriate.
3300 Vmouse_leave_frame_hook = Qnil;
3302 DEFVAR_LISP ("map-frame-hook", &Vmap_frame_hook /*
3303 Function or functions to call when a frame is mapped.
3304 One argument, the frame.
3306 Vmap_frame_hook = Qnil;
3308 DEFVAR_LISP ("unmap-frame-hook", &Vunmap_frame_hook /*
3309 Function or functions to call when a frame is unmapped.
3310 One argument, the frame.
3312 Vunmap_frame_hook = Qnil;
3314 DEFVAR_BOOL ("allow-deletion-of-last-visible-frame",
3315 &allow_deletion_of_last_visible_frame /*
3316 *Non-nil means to assume the force option to delete-frame.
3318 allow_deletion_of_last_visible_frame = 0;
3320 DEFVAR_LISP ("adjust-frame-function", &Vadjust_frame_function /*
3321 Function or constant controlling adjustment of frame.
3322 When scrollbars, toolbars, default font etc. change in frame, the frame
3323 needs to be adjusted. The adjustment is controlled by this variable.
3325 nil to keep character frame size unchanged when possible (resize)
3326 t to keep pixel size unchanged (never resize)
3327 function symbol or lambda form. This function must return boolean
3328 value which is treated as above. Function is passed one parameter,
3329 the frame being adjusted. It function should not modify or delete
3332 Vadjust_frame_function = Qnil;
3334 DEFVAR_LISP ("mouse-motion-handler", &Vmouse_motion_handler /*
3335 Handler for motion events. One arg, the event.
3336 For most applications, you should use `mode-motion-hook' instead of this.
3338 Vmouse_motion_handler = Qnil;
3340 DEFVAR_LISP ("synchronize-minibuffers",&Vsynchronize_minibuffers /*
3341 Set to t if all minibuffer windows are to be synchronized.
3342 This will cause echo area messages to appear in the minibuffers of all
3345 Vsynchronize_minibuffers = Qnil;
3347 DEFVAR_LISP ("frame-title-format", &Vframe_title_format /*
3348 Controls the title of the X window corresponding to the selected frame.
3349 This is the same format as `modeline-format' with the exception that
3352 Vframe_title_format = build_string ("%S: %b");
3354 DEFVAR_LISP ("frame-icon-title-format", &Vframe_icon_title_format /*
3355 Controls the title of the icon corresponding to the selected frame.
3356 See also the variable `frame-title-format'.
3358 Vframe_icon_title_format = build_string ("%b");
3360 DEFVAR_LISP ("default-frame-name", &Vdefault_frame_name /*
3361 The default name to assign to newly-created frames.
3362 This can be overridden by arguments to `make-frame'.
3363 This must be a string.
3366 Vdefault_frame_name = build_string ("emacs");
3368 Vdefault_frame_name = build_string ("InfoDock");
3371 DEFVAR_LISP ("default-frame-plist", &Vdefault_frame_plist /*
3372 Plist of default values for frame creation, other than the first one.
3373 These may be set in your init file, like this:
3375 \(setq default-frame-plist '(width 80 height 55))
3377 The properties may be in alist format for backward compatibility
3378 but you should not rely on this behavior.
3380 These override values given in window system configuration data,
3381 including X Windows' defaults database.
3383 Since the first X frame is created before loading your .emacs file,
3384 you must use the X resource database for that.
3386 For values specific to the first Emacs frame, see `initial-frame-plist'.
3387 For values specific to the separate minibuffer frame, see
3388 `minibuffer-frame-plist'.
3390 See also the variables `default-x-frame-plist' and
3391 `default-tty-frame-plist', which are like `default-frame-plist'
3392 except that they apply only to X or tty frames, respectively
3393 \(whereas `default-frame-plist' applies to all types of frames).
3395 Vdefault_frame_plist = Qnil;
3397 DEFVAR_LISP ("frame-icon-glyph", &Vframe_icon_glyph /*
3398 Icon glyph used to iconify a frame.
3403 complex_vars_of_frame (void)
3405 Vframe_icon_glyph = allocate_glyph (GLYPH_ICON, icon_glyph_changed);