Commit | Line | Data |
---|---|---|
ff11dfa1 | 1 | /* Generic frame functions. |
0b5538bd | 2 | Copyright (C) 1993, 1994, 1995, 1997, 1999, 2000, 2001, 2002, 2003, |
aaef169d | 3 | 2004, 2005, 2006 Free Software Foundation, Inc. |
dc6f92b8 JB |
4 | |
5 | This file is part of GNU Emacs. | |
6 | ||
7 | GNU Emacs is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
1113d9db | 9 | the Free Software Foundation; either version 2, or (at your option) |
dc6f92b8 JB |
10 | any later version. |
11 | ||
12 | GNU Emacs is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with GNU Emacs; see the file COPYING. If not, write to | |
4fc5845f LK |
19 | the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
20 | Boston, MA 02110-1301, USA. */ | |
dc6f92b8 | 21 | |
18160b98 | 22 | #include <config.h> |
565620a5 RS |
23 | |
24 | #include <stdio.h> | |
cc38027b | 25 | #include "lisp.h" |
71025e5e | 26 | #include "charset.h" |
6d55d620 | 27 | #ifdef HAVE_X_WINDOWS |
dfcf069d | 28 | #include "xterm.h" |
71025e5e | 29 | #endif |
8f23f280 AI |
30 | #ifdef WINDOWSNT |
31 | #include "w32term.h" | |
32 | #endif | |
e0f712ba | 33 | #ifdef MAC_OS |
1a578e9b AC |
34 | #include "macterm.h" |
35 | #endif | |
2538fae4 AI |
36 | #include "buffer.h" |
37 | /* These help us bind and responding to switch-frame events. */ | |
38 | #include "commands.h" | |
39 | #include "keyboard.h" | |
cc38027b | 40 | #include "frame.h" |
a1dfb88a KH |
41 | #ifdef HAVE_WINDOW_SYSTEM |
42 | #include "fontset.h" | |
43 | #endif | |
972f4259 | 44 | #include "blockinput.h" |
bc1ed486 | 45 | #include "termhooks.h" |
dfcf069d | 46 | #include "dispextern.h" |
f769f1b2 | 47 | #include "window.h" |
87485d6f MW |
48 | #ifdef MSDOS |
49 | #include "msdos.h" | |
4aec4b29 | 50 | #include "dosfns.h" |
87485d6f | 51 | #endif |
e5d77022 | 52 | |
972f4259 | 53 | |
2731a0ad KS |
54 | #ifdef HAVE_WINDOW_SYSTEM |
55 | ||
972f4259 KS |
56 | /* The name we're using in resource queries. Most often "emacs". */ |
57 | ||
58 | Lisp_Object Vx_resource_name; | |
59 | ||
60 | /* The application class we're using in resource queries. | |
61 | Normally "Emacs". */ | |
62 | ||
63 | Lisp_Object Vx_resource_class; | |
64 | ||
2731a0ad | 65 | #endif |
972f4259 KS |
66 | |
67 | Lisp_Object Qframep, Qframe_live_p; | |
68 | Lisp_Object Qicon, Qmodeline; | |
fd0c2bd1 | 69 | Lisp_Object Qonly; |
972f4259 | 70 | Lisp_Object Qx, Qw32, Qmac, Qpc; |
f7af3f7b | 71 | Lisp_Object Qvisible; |
8b60f7bc | 72 | Lisp_Object Qdisplay_type; |
6345f6aa | 73 | Lisp_Object Qbackground_mode; |
3df1fda2 | 74 | Lisp_Object Qinhibit_default_face_x_resources; |
972f4259 KS |
75 | |
76 | Lisp_Object Qx_frame_parameter; | |
77 | Lisp_Object Qx_resource_name; | |
78 | ||
79 | /* Frame parameters (set or reported). */ | |
80 | ||
81 | Lisp_Object Qauto_raise, Qauto_lower; | |
82 | Lisp_Object Qborder_color, Qborder_width; | |
83 | Lisp_Object Qcursor_color, Qcursor_type; | |
84 | Lisp_Object Qgeometry; /* Not used */ | |
85 | Lisp_Object Qheight, Qwidth; | |
86 | Lisp_Object Qleft, Qright; | |
87 | Lisp_Object Qicon_left, Qicon_top, Qicon_type, Qicon_name; | |
88 | Lisp_Object Qinternal_border_width; | |
89 | Lisp_Object Qmouse_color; | |
90 | Lisp_Object Qminibuffer; | |
91 | Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars; | |
92 | Lisp_Object Qvisibility; | |
93 | Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background; | |
94 | Lisp_Object Qscreen_gamma; | |
95 | Lisp_Object Qline_spacing; | |
96 | Lisp_Object Quser_position, Quser_size; | |
97 | Lisp_Object Qwait_for_wm; | |
98 | Lisp_Object Qwindow_id; | |
99 | #ifdef HAVE_X_WINDOWS | |
100 | Lisp_Object Qouter_window_id; | |
101 | #endif | |
102 | Lisp_Object Qparent_id; | |
103 | Lisp_Object Qtitle, Qname; | |
104 | Lisp_Object Qunsplittable; | |
105 | Lisp_Object Qmenu_bar_lines, Qtool_bar_lines; | |
106 | Lisp_Object Qleft_fringe, Qright_fringe; | |
107 | Lisp_Object Qbuffer_predicate, Qbuffer_list; | |
94674d18 | 108 | Lisp_Object Qtty_color_mode; |
dc6f92b8 | 109 | |
972f4259 KS |
110 | Lisp_Object Qfullscreen, Qfullwidth, Qfullheight, Qfullboth; |
111 | ||
112 | Lisp_Object Qface_set_after_frame_default; | |
113 | ||
114 | ||
a249de79 | 115 | Lisp_Object Vterminal_frame; |
a1aaa23f | 116 | Lisp_Object Vdefault_frame_alist; |
a6e20602 | 117 | Lisp_Object Vdefault_frame_scroll_bars; |
beb0bc36 | 118 | Lisp_Object Vmouse_position_function; |
6018080f | 119 | Lisp_Object Vmouse_highlight; |
cd1d850f | 120 | Lisp_Object Vdelete_frame_functions; |
a249de79 RS |
121 | \f |
122 | static void | |
123 | set_menu_bar_lines_1 (window, n) | |
124 | Lisp_Object window; | |
125 | int n; | |
126 | { | |
127 | struct window *w = XWINDOW (window); | |
128 | ||
57aeea1e | 129 | XSETFASTINT (w->last_modified, 0); |
5af5757b KS |
130 | XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n); |
131 | XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n); | |
177c0ea7 | 132 | |
5af5757b KS |
133 | if (INTEGERP (w->orig_top_line)) |
134 | XSETFASTINT (w->orig_top_line, XFASTINT (w->orig_top_line) + n); | |
135 | if (INTEGERP (w->orig_total_lines)) | |
136 | XSETFASTINT (w->orig_total_lines, XFASTINT (w->orig_total_lines) - n); | |
a249de79 RS |
137 | |
138 | /* Handle just the top child in a vertical split. */ | |
139 | if (!NILP (w->vchild)) | |
140 | set_menu_bar_lines_1 (w->vchild, n); | |
141 | ||
142 | /* Adjust all children in a horizontal split. */ | |
143 | for (window = w->hchild; !NILP (window); window = w->next) | |
144 | { | |
145 | w = XWINDOW (window); | |
146 | set_menu_bar_lines_1 (window, n); | |
147 | } | |
148 | } | |
149 | ||
e48f782c | 150 | void |
a249de79 RS |
151 | set_menu_bar_lines (f, value, oldval) |
152 | struct frame *f; | |
153 | Lisp_Object value, oldval; | |
154 | { | |
155 | int nlines; | |
156 | int olines = FRAME_MENU_BAR_LINES (f); | |
157 | ||
158 | /* Right now, menu bars don't work properly in minibuf-only frames; | |
159 | most of the commands try to apply themselves to the minibuffer | |
e3678b64 | 160 | frame itself, and get an error because you can't switch buffers |
a249de79 RS |
161 | in or split the minibuffer window. */ |
162 | if (FRAME_MINIBUF_ONLY_P (f)) | |
163 | return; | |
164 | ||
165 | if (INTEGERP (value)) | |
166 | nlines = XINT (value); | |
167 | else | |
168 | nlines = 0; | |
169 | ||
57aeea1e RS |
170 | if (nlines != olines) |
171 | { | |
172 | windows_or_buffers_changed++; | |
173 | FRAME_WINDOW_SIZES_CHANGED (f) = 1; | |
174 | FRAME_MENU_BAR_LINES (f) = nlines; | |
175 | set_menu_bar_lines_1 (f->root_window, nlines - olines); | |
18082e2d | 176 | adjust_glyphs (f); |
57aeea1e | 177 | } |
a249de79 RS |
178 | } |
179 | \f | |
a249de79 RS |
180 | Lisp_Object Vemacs_iconified; |
181 | Lisp_Object Vframe_list; | |
a249de79 | 182 | |
2d764c78 EZ |
183 | struct x_output tty_display; |
184 | ||
dc6f92b8 JB |
185 | extern Lisp_Object Vminibuffer_list; |
186 | extern Lisp_Object get_minibuffer (); | |
84386599 RS |
187 | extern Lisp_Object Fhandle_switch_frame (); |
188 | extern Lisp_Object Fredirect_frame_focus (); | |
a54d3a73 | 189 | extern Lisp_Object x_get_focus_frame (); |
dc6f92b8 | 190 | \f |
ff11dfa1 | 191 | DEFUN ("framep", Fframep, Sframep, 1, 1, 0, |
14ff1ee0 PJ |
192 | doc: /* Return non-nil if OBJECT is a frame. |
193 | Value is t for a termcap frame (a character-only terminal), | |
194 | `x' for an Emacs frame that is really an X window, | |
195 | `w32' for an Emacs frame that is a window on MS-Windows display, | |
196 | `mac' for an Emacs frame on a Macintosh display, | |
197 | `pc' for a direct-write MS-DOS frame. | |
198 | See also `frame-live-p'. */) | |
199 | (object) | |
f9898cc6 | 200 | Lisp_Object object; |
dc6f92b8 | 201 | { |
e35d291d | 202 | if (!FRAMEP (object)) |
dc6f92b8 | 203 | return Qnil; |
ff11dfa1 | 204 | switch (XFRAME (object)->output_method) |
dc6f92b8 JB |
205 | { |
206 | case output_termcap: | |
207 | return Qt; | |
208 | case output_x_window: | |
fd0c2bd1 | 209 | return Qx; |
fbd6baed GV |
210 | case output_w32: |
211 | return Qw32; | |
bb221971 RS |
212 | case output_msdos_raw: |
213 | return Qpc; | |
574a1a90 RS |
214 | case output_mac: |
215 | return Qmac; | |
dc6f92b8 JB |
216 | default: |
217 | abort (); | |
218 | } | |
219 | } | |
220 | ||
dbc4e1c1 | 221 | DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0, |
14ff1ee0 PJ |
222 | doc: /* Return non-nil if OBJECT is a frame which has not been deleted. |
223 | Value is nil if OBJECT is not a live frame. If object is a live | |
224 | frame, the return value indicates what sort of output device it is | |
f6fa0866 | 225 | displayed on. See the documentation of `framep' for possible |
4e10df59 | 226 | return values. */) |
14ff1ee0 | 227 | (object) |
f9898cc6 JB |
228 | Lisp_Object object; |
229 | { | |
ff11dfa1 JB |
230 | return ((FRAMEP (object) |
231 | && FRAME_LIVE_P (XFRAME (object))) | |
232 | ? Fframep (object) | |
f9898cc6 JB |
233 | : Qnil); |
234 | } | |
235 | ||
ff11dfa1 JB |
236 | struct frame * |
237 | make_frame (mini_p) | |
dc6f92b8 JB |
238 | int mini_p; |
239 | { | |
ff11dfa1 JB |
240 | Lisp_Object frame; |
241 | register struct frame *f; | |
dc6f92b8 JB |
242 | register Lisp_Object root_window; |
243 | register Lisp_Object mini_window; | |
e9c96c62 GM |
244 | |
245 | f = allocate_frame (); | |
36af7d69 | 246 | XSETFRAME (frame, f); |
ff11dfa1 | 247 | |
18082e2d GM |
248 | f->desired_matrix = 0; |
249 | f->current_matrix = 0; | |
250 | f->desired_pool = 0; | |
251 | f->current_pool = 0; | |
252 | f->glyphs_initialized_p = 0; | |
253 | f->decode_mode_spec_buffer = 0; | |
ff11dfa1 | 254 | f->visible = 0; |
323405de | 255 | f->async_visible = 0; |
7556890b | 256 | f->output_data.nothing = 0; |
ff11dfa1 | 257 | f->iconified = 0; |
323405de | 258 | f->async_iconified = 0; |
ff11dfa1 JB |
259 | f->wants_modeline = 1; |
260 | f->auto_raise = 0; | |
261 | f->auto_lower = 0; | |
262 | f->no_split = 0; | |
10689a01 | 263 | f->garbaged = 1; |
ff11dfa1 | 264 | f->has_minibuffer = mini_p; |
a42e9724 | 265 | f->focus_frame = Qnil; |
804518aa | 266 | f->explicit_name = 0; |
fd2777e0 | 267 | f->can_have_scroll_bars = 0; |
3a43d2dd | 268 | f->vertical_scroll_bar_type = vertical_scroll_bar_none; |
ff11dfa1 | 269 | f->param_alist = Qnil; |
fd2777e0 JB |
270 | f->scroll_bars = Qnil; |
271 | f->condemned_scroll_bars = Qnil; | |
306cc902 | 272 | f->face_alist = Qnil; |
18082e2d | 273 | f->face_cache = NULL; |
9dd935ee | 274 | f->menu_bar_items = Qnil; |
c8b8e7e3 RS |
275 | f->menu_bar_vector = Qnil; |
276 | f->menu_bar_items_used = 0; | |
329ca574 | 277 | f->buffer_predicate = Qnil; |
fa54c6ae | 278 | f->buffer_list = Qnil; |
b4f0ee5d KH |
279 | #ifdef MULTI_KBOARD |
280 | f->kboard = initial_kboard; | |
281 | #endif | |
aec6e486 | 282 | f->namebuf = 0; |
2b1c9cfb | 283 | f->title = Qnil; |
18082e2d | 284 | f->menu_bar_window = Qnil; |
9ea173e8 | 285 | f->tool_bar_window = Qnil; |
61752261 | 286 | f->tool_bar_items = Qnil; |
9ea173e8 | 287 | f->desired_tool_bar_string = f->current_tool_bar_string = Qnil; |
61752261 | 288 | f->n_tool_bar_items = 0; |
5af5757b KS |
289 | f->left_fringe_width = f->right_fringe_width = 0; |
290 | f->fringe_cols = 0; | |
291 | f->scroll_bar_actual_width = 0; | |
292 | f->border_width = 0; | |
293 | f->internal_border_width = 0; | |
294 | f->column_width = 1; /* !FRAME_WINDOW_P value */ | |
295 | f->line_height = 1; /* !FRAME_WINDOW_P value */ | |
296 | f->x_pixels_diff = f->y_pixels_diff = 0; | |
93421a1f | 297 | #ifdef HAVE_WINDOW_SYSTEM |
5af5757b | 298 | f->want_fullscreen = FULLSCREEN_NONE; |
93421a1f | 299 | #endif |
5af5757b KS |
300 | f->size_hint_flags = 0; |
301 | f->win_gravity = 0; | |
dc6f92b8 | 302 | |
cc38027b | 303 | root_window = make_window (); |
dc6f92b8 JB |
304 | if (mini_p) |
305 | { | |
cc38027b | 306 | mini_window = make_window (); |
dc6f92b8 JB |
307 | XWINDOW (root_window)->next = mini_window; |
308 | XWINDOW (mini_window)->prev = root_window; | |
309 | XWINDOW (mini_window)->mini_p = Qt; | |
ff11dfa1 JB |
310 | XWINDOW (mini_window)->frame = frame; |
311 | f->minibuffer_window = mini_window; | |
dc6f92b8 JB |
312 | } |
313 | else | |
314 | { | |
315 | mini_window = Qnil; | |
316 | XWINDOW (root_window)->next = Qnil; | |
ff11dfa1 | 317 | f->minibuffer_window = Qnil; |
dc6f92b8 JB |
318 | } |
319 | ||
ff11dfa1 | 320 | XWINDOW (root_window)->frame = frame; |
dc6f92b8 JB |
321 | |
322 | /* 10 is arbitrary, | |
323 | just so that there is "something there." | |
ff11dfa1 | 324 | Correct size will be set up later with change_frame_size. */ |
dc6f92b8 | 325 | |
5af5757b KS |
326 | SET_FRAME_COLS (f, 10); |
327 | FRAME_LINES (f) = 10; | |
dc6f92b8 | 328 | |
5af5757b KS |
329 | XSETFASTINT (XWINDOW (root_window)->total_cols, 10); |
330 | XSETFASTINT (XWINDOW (root_window)->total_lines, (mini_p ? 9 : 10)); | |
dc6f92b8 JB |
331 | |
332 | if (mini_p) | |
333 | { | |
5af5757b KS |
334 | XSETFASTINT (XWINDOW (mini_window)->total_cols, 10); |
335 | XSETFASTINT (XWINDOW (mini_window)->top_line, 9); | |
336 | XSETFASTINT (XWINDOW (mini_window)->total_lines, 1); | |
dc6f92b8 JB |
337 | } |
338 | ||
ff11dfa1 | 339 | /* Choose a buffer for the frame's root window. */ |
5bce042c JB |
340 | { |
341 | Lisp_Object buf; | |
342 | ||
343 | XWINDOW (root_window)->buffer = Qt; | |
344 | buf = Fcurrent_buffer (); | |
345 | /* If buf is a 'hidden' buffer (i.e. one whose name starts with | |
346 | a space), try to find another one. */ | |
d5db4077 | 347 | if (SREF (Fbuffer_name (buf), 0) == ' ') |
98ce1622 | 348 | buf = Fother_buffer (buf, Qnil, Qnil); |
fa54c6ae | 349 | |
18082e2d GM |
350 | /* Use set_window_buffer, not Fset_window_buffer, and don't let |
351 | hooks be run by it. The reason is that the whole frame/window | |
352 | arrangement is not yet fully intialized at this point. Windows | |
353 | don't have the right size, glyph matrices aren't initialized | |
354 | etc. Running Lisp functions at this point surely ends in a | |
355 | SEGV. */ | |
5af5757b | 356 | set_window_buffer (root_window, buf, 0, 0); |
fa54c6ae | 357 | f->buffer_list = Fcons (buf, Qnil); |
5bce042c JB |
358 | } |
359 | ||
dc6f92b8 JB |
360 | if (mini_p) |
361 | { | |
362 | XWINDOW (mini_window)->buffer = Qt; | |
18082e2d GM |
363 | set_window_buffer (mini_window, |
364 | (NILP (Vminibuffer_list) | |
365 | ? get_minibuffer (0) | |
366 | : Fcar (Vminibuffer_list)), | |
5af5757b | 367 | 0, 0); |
dc6f92b8 JB |
368 | } |
369 | ||
ff11dfa1 JB |
370 | f->root_window = root_window; |
371 | f->selected_window = root_window; | |
d5e7c279 JB |
372 | /* Make sure this window seems more recently used than |
373 | a newly-created, never-selected window. */ | |
2a1893f4 SM |
374 | ++window_select_count; |
375 | XSETFASTINT (XWINDOW (f->selected_window)->use_time, window_select_count); | |
dc6f92b8 | 376 | |
a5f696ac JD |
377 | f->default_face_done_p = 0; |
378 | ||
ff11dfa1 | 379 | return f; |
dc6f92b8 JB |
380 | } |
381 | \f | |
bba88bb1 | 382 | #ifdef HAVE_WINDOW_SYSTEM |
ff11dfa1 | 383 | /* Make a frame using a separate minibuffer window on another frame. |
dc6f92b8 JB |
384 | MINI_WINDOW is the minibuffer window to use. nil means use the |
385 | default (the global minibuffer). */ | |
386 | ||
ff11dfa1 | 387 | struct frame * |
b0660239 | 388 | make_frame_without_minibuffer (mini_window, kb, display) |
dc6f92b8 | 389 | register Lisp_Object mini_window; |
662ac59a | 390 | KBOARD *kb; |
b0660239 | 391 | Lisp_Object display; |
dc6f92b8 | 392 | { |
ff11dfa1 | 393 | register struct frame *f; |
363b873b | 394 | struct gcpro gcpro1; |
dc6f92b8 | 395 | |
b0660239 | 396 | if (!NILP (mini_window)) |
b7826503 | 397 | CHECK_LIVE_WINDOW (mini_window); |
dc6f92b8 | 398 | |
662ac59a | 399 | #ifdef MULTI_KBOARD |
b0660239 KH |
400 | if (!NILP (mini_window) |
401 | && XFRAME (XWINDOW (mini_window)->frame)->kboard != kb) | |
b5251fe7 | 402 | error ("Frame and minibuffer must be on the same display"); |
662ac59a KH |
403 | #endif |
404 | ||
ff11dfa1 JB |
405 | /* Make a frame containing just a root window. */ |
406 | f = make_frame (0); | |
dc6f92b8 | 407 | |
b0660239 KH |
408 | if (NILP (mini_window)) |
409 | { | |
410 | /* Use default-minibuffer-frame if possible. */ | |
411 | if (!FRAMEP (kb->Vdefault_minibuffer_frame) | |
412 | || ! FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))) | |
413 | { | |
363b873b RS |
414 | Lisp_Object frame_dummy; |
415 | ||
416 | XSETFRAME (frame_dummy, f); | |
417 | GCPRO1 (frame_dummy); | |
b0660239 | 418 | /* If there's no minibuffer frame to use, create one. */ |
363b873b RS |
419 | kb->Vdefault_minibuffer_frame = |
420 | call1 (intern ("make-initial-minibuffer-frame"), display); | |
421 | UNGCPRO; | |
b0660239 | 422 | } |
177c0ea7 | 423 | |
b0660239 KH |
424 | mini_window = XFRAME (kb->Vdefault_minibuffer_frame)->minibuffer_window; |
425 | } | |
a2812a26 | 426 | |
ff11dfa1 | 427 | f->minibuffer_window = mini_window; |
a2812a26 RS |
428 | |
429 | /* Make the chosen minibuffer window display the proper minibuffer, | |
430 | unless it is already showing a minibuffer. */ | |
431 | if (NILP (Fmemq (XWINDOW (mini_window)->buffer, Vminibuffer_list))) | |
432 | Fset_window_buffer (mini_window, | |
433 | (NILP (Vminibuffer_list) | |
434 | ? get_minibuffer (0) | |
5af5757b | 435 | : Fcar (Vminibuffer_list)), Qnil); |
ff11dfa1 | 436 | return f; |
dc6f92b8 JB |
437 | } |
438 | ||
ff11dfa1 | 439 | /* Make a frame containing only a minibuffer window. */ |
dc6f92b8 | 440 | |
ff11dfa1 JB |
441 | struct frame * |
442 | make_minibuffer_frame () | |
dc6f92b8 | 443 | { |
ff11dfa1 | 444 | /* First make a frame containing just a root window, no minibuffer. */ |
dc6f92b8 | 445 | |
ff11dfa1 | 446 | register struct frame *f = make_frame (0); |
dc6f92b8 | 447 | register Lisp_Object mini_window; |
ff11dfa1 | 448 | register Lisp_Object frame; |
dc6f92b8 | 449 | |
2d80a27a | 450 | XSETFRAME (frame, f); |
dc6f92b8 | 451 | |
804518aa | 452 | f->auto_raise = 0; |
ff11dfa1 JB |
453 | f->auto_lower = 0; |
454 | f->no_split = 1; | |
455 | f->wants_modeline = 0; | |
456 | f->has_minibuffer = 1; | |
dc6f92b8 JB |
457 | |
458 | /* Now label the root window as also being the minibuffer. | |
459 | Avoid infinite looping on the window chain by marking next pointer | |
460 | as nil. */ | |
461 | ||
ff11dfa1 | 462 | mini_window = f->minibuffer_window = f->root_window; |
dc6f92b8 JB |
463 | XWINDOW (mini_window)->mini_p = Qt; |
464 | XWINDOW (mini_window)->next = Qnil; | |
804518aa | 465 | XWINDOW (mini_window)->prev = Qnil; |
ff11dfa1 | 466 | XWINDOW (mini_window)->frame = frame; |
dc6f92b8 JB |
467 | |
468 | /* Put the proper buffer in that window. */ | |
469 | ||
470 | Fset_window_buffer (mini_window, | |
265a9e55 | 471 | (NILP (Vminibuffer_list) |
dc6f92b8 | 472 | ? get_minibuffer (0) |
5af5757b | 473 | : Fcar (Vminibuffer_list)), Qnil); |
ff11dfa1 | 474 | return f; |
dc6f92b8 | 475 | } |
bba88bb1 | 476 | #endif /* HAVE_WINDOW_SYSTEM */ |
dc6f92b8 | 477 | \f |
ff11dfa1 | 478 | /* Construct a frame that refers to the terminal (stdin and stdout). */ |
dc6f92b8 | 479 | |
bb1513c9 RS |
480 | static int terminal_frame_count; |
481 | ||
ff11dfa1 JB |
482 | struct frame * |
483 | make_terminal_frame () | |
dc6f92b8 | 484 | { |
ff11dfa1 | 485 | register struct frame *f; |
d063751a | 486 | Lisp_Object frame; |
bb1513c9 RS |
487 | char name[20]; |
488 | ||
b4f0ee5d KH |
489 | #ifdef MULTI_KBOARD |
490 | if (!initial_kboard) | |
491 | { | |
492 | initial_kboard = (KBOARD *) xmalloc (sizeof (KBOARD)); | |
493 | init_kboard (initial_kboard); | |
a1b658dd KH |
494 | initial_kboard->next_kboard = all_kboards; |
495 | all_kboards = initial_kboard; | |
b4f0ee5d KH |
496 | } |
497 | #endif | |
498 | ||
bb1513c9 RS |
499 | /* The first call must initialize Vframe_list. */ |
500 | if (! (NILP (Vframe_list) || CONSP (Vframe_list))) | |
501 | Vframe_list = Qnil; | |
ff11dfa1 | 502 | |
ff11dfa1 | 503 | f = make_frame (1); |
d063751a | 504 | |
2d80a27a | 505 | XSETFRAME (frame, f); |
d063751a RS |
506 | Vframe_list = Fcons (frame, Vframe_list); |
507 | ||
bb1513c9 | 508 | terminal_frame_count++; |
0303e8da RS |
509 | sprintf (name, "F%d", terminal_frame_count); |
510 | f->name = build_string (name); | |
bb1513c9 | 511 | |
bb1513c9 RS |
512 | f->visible = 1; /* FRAME_SET_VISIBLE wd set frame_garbaged. */ |
513 | f->async_visible = 1; /* Don't let visible be cleared later. */ | |
bb221971 RS |
514 | #ifdef MSDOS |
515 | f->output_data.x = &the_only_x_display; | |
2d764c78 EZ |
516 | if (!inhibit_window_system |
517 | && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame)) | |
518 | || XFRAME (selected_frame)->output_method == output_msdos_raw)) | |
65606f5e EZ |
519 | { |
520 | f->output_method = output_msdos_raw; | |
521 | /* This initialization of foreground and background pixels is | |
522 | only important for the initial frame created in temacs. If | |
523 | we don't do that, we get black background and foreground in | |
524 | the dumped Emacs because the_only_x_display is a static | |
525 | variable, hence it is born all-zeroes, and zero is the code | |
526 | for the black color. Other frames all inherit their pixels | |
527 | from what's already in the_only_x_display. */ | |
528 | if ((!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))) | |
529 | && f->output_data.x->background_pixel == 0 | |
530 | && f->output_data.x->foreground_pixel == 0) | |
531 | { | |
532 | f->output_data.x->background_pixel = FACE_TTY_DEFAULT_BG_COLOR; | |
533 | f->output_data.x->foreground_pixel = FACE_TTY_DEFAULT_FG_COLOR; | |
534 | } | |
535 | } | |
2d764c78 EZ |
536 | else |
537 | f->output_method = output_termcap; | |
538 | #else | |
4ec0d3c1 | 539 | #ifdef WINDOWSNT |
ff8d4bf4 | 540 | f->output_method = output_termcap; |
4ec0d3c1 AI |
541 | f->output_data.x = &tty_display; |
542 | #else | |
e0f712ba | 543 | #ifdef MAC_OS8 |
1a578e9b AC |
544 | make_mac_terminal_frame (f); |
545 | #else | |
2d764c78 | 546 | f->output_data.x = &tty_display; |
58bd8318 KS |
547 | #ifdef CANNOT_DUMP |
548 | FRAME_FOREGROUND_PIXEL(f) = FACE_TTY_DEFAULT_FG_COLOR; | |
549 | FRAME_BACKGROUND_PIXEL(f) = FACE_TTY_DEFAULT_BG_COLOR; | |
550 | #endif | |
e0f712ba | 551 | #endif /* MAC_OS8 */ |
4ec0d3c1 | 552 | #endif /* WINDOWSNT */ |
2d764c78 | 553 | #endif /* MSDOS */ |
574a1a90 | 554 | |
1a6d3623 EZ |
555 | if (!noninteractive) |
556 | init_frame_faces (f); | |
1a578e9b | 557 | |
ff11dfa1 | 558 | return f; |
dc6f92b8 | 559 | } |
bb1513c9 RS |
560 | |
561 | DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame, | |
14ff1ee0 PJ |
562 | 1, 1, 0, |
563 | doc: /* Create an additional terminal frame. | |
564 | You can create multiple frames on a text-only terminal in this way. | |
565 | Only the selected terminal frame is actually displayed. | |
566 | This function takes one argument, an alist specifying frame parameters. | |
567 | In practice, generally you don't need to specify any parameters. | |
568 | Note that changing the size of one terminal frame automatically affects all. */) | |
569 | (parms) | |
bb1513c9 RS |
570 | Lisp_Object parms; |
571 | { | |
572 | struct frame *f; | |
574a1a90 | 573 | Lisp_Object frame, tem; |
8d2666fe | 574 | struct frame *sf = SELECTED_FRAME (); |
bb1513c9 | 575 | |
541580aa | 576 | #ifdef MSDOS |
2d764c78 EZ |
577 | if (sf->output_method != output_msdos_raw |
578 | && sf->output_method != output_termcap) | |
bb221971 | 579 | abort (); |
574a1a90 RS |
580 | #else /* not MSDOS */ |
581 | ||
e0f712ba | 582 | #ifdef MAC_OS |
8d2666fe | 583 | if (sf->output_method != output_mac) |
574a1a90 | 584 | error ("Not running on a Macintosh screen; cannot make a new Macintosh frame"); |
bb221971 | 585 | #else |
8d2666fe | 586 | if (sf->output_method != output_termcap) |
bb1513c9 | 587 | error ("Not using an ASCII terminal now; cannot make a new ASCII frame"); |
bb221971 | 588 | #endif |
574a1a90 | 589 | #endif /* not MSDOS */ |
bb1513c9 RS |
590 | |
591 | f = make_terminal_frame (); | |
574a1a90 | 592 | |
5af5757b KS |
593 | change_frame_size (f, FRAME_LINES (sf), |
594 | FRAME_COLS (sf), 0, 0, 0); | |
18082e2d | 595 | adjust_glyphs (f); |
bb1513c9 RS |
596 | calculate_costs (f); |
597 | XSETFRAME (frame, f); | |
8adfc1ec | 598 | Fmodify_frame_parameters (frame, Vdefault_frame_alist); |
bb1513c9 | 599 | Fmodify_frame_parameters (frame, parms); |
87f1940e EZ |
600 | |
601 | /* Make the frame face alist be frame-specific, so that each | |
602 | frame could change its face definitions independently. */ | |
8d2666fe | 603 | f->face_alist = Fcopy_alist (sf->face_alist); |
87f1940e EZ |
604 | /* Simple Fcopy_alist isn't enough, because we need the contents of |
605 | the vectors which are the CDRs of associations in face_alist to | |
606 | be copied as well. */ | |
607 | for (tem = f->face_alist; CONSP (tem); tem = XCDR (tem)) | |
f3fbd155 | 608 | XSETCDR (XCAR (tem), Fcopy_sequence (XCDR (XCAR (tem)))); |
bb1513c9 RS |
609 | return frame; |
610 | } | |
1e8324d9 | 611 | |
dc6f92b8 | 612 | \f |
1e8324d9 GM |
613 | /* Perform the switch to frame FRAME. |
614 | ||
615 | If FRAME is a switch-frame event `(switch-frame FRAME1)', use | |
616 | FRAME1 as frame. | |
617 | ||
618 | If TRACK is non-zero and the frame that currently has the focus | |
619 | redirects its focus to the selected frame, redirect that focused | |
620 | frame's focus to FRAME instead. | |
621 | ||
622 | FOR_DELETION non-zero means that the selected frame is being | |
623 | deleted, which includes the possibility that the frame's display | |
624 | is dead. */ | |
625 | ||
61f94483 | 626 | Lisp_Object |
1e8324d9 GM |
627 | do_switch_frame (frame, track, for_deletion) |
628 | Lisp_Object frame; | |
629 | int track, for_deletion; | |
dc6f92b8 | 630 | { |
8d2666fe | 631 | struct frame *sf = SELECTED_FRAME (); |
177c0ea7 | 632 | |
2f0b07e0 JB |
633 | /* If FRAME is a switch-frame event, extract the frame we should |
634 | switch to. */ | |
635 | if (CONSP (frame) | |
7539e11f KR |
636 | && EQ (XCAR (frame), Qswitch_frame) |
637 | && CONSP (XCDR (frame))) | |
638 | frame = XCAR (XCDR (frame)); | |
2f0b07e0 | 639 | |
09907c3a KH |
640 | /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for |
641 | a switch-frame event to arrive after a frame is no longer live, | |
642 | especially when deleting the initial frame during startup. */ | |
b7826503 | 643 | CHECK_FRAME (frame); |
09907c3a KH |
644 | if (! FRAME_LIVE_P (XFRAME (frame))) |
645 | return Qnil; | |
dc6f92b8 | 646 | |
8d2666fe | 647 | if (sf == XFRAME (frame)) |
ff11dfa1 | 648 | return frame; |
dc6f92b8 | 649 | |
0aed85f4 KH |
650 | /* This is too greedy; it causes inappropriate focus redirection |
651 | that's hard to get rid of. */ | |
652 | #if 0 | |
a42e9724 JB |
653 | /* If a frame's focus has been redirected toward the currently |
654 | selected frame, we should change the redirection to point to the | |
655 | newly selected frame. This means that if the focus is redirected | |
656 | from a minibufferless frame to a surrogate minibuffer frame, we | |
657 | can use `other-window' to switch between all the frames using | |
658 | that minibuffer frame, and the focus redirection will follow us | |
659 | around. */ | |
0aed85f4 KH |
660 | if (track) |
661 | { | |
662 | Lisp_Object tail; | |
a42e9724 | 663 | |
7539e11f | 664 | for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail)) |
0aed85f4 KH |
665 | { |
666 | Lisp_Object focus; | |
a42e9724 | 667 | |
7539e11f | 668 | if (!FRAMEP (XCAR (tail))) |
0aed85f4 | 669 | abort (); |
a42e9724 | 670 | |
7539e11f | 671 | focus = FRAME_FOCUS_FRAME (XFRAME (XCAR (tail))); |
a42e9724 | 672 | |
8d2666fe | 673 | if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ()) |
7539e11f | 674 | Fredirect_frame_focus (XCAR (tail), frame); |
0aed85f4 KH |
675 | } |
676 | } | |
677 | #else /* ! 0 */ | |
678 | /* Instead, apply it only to the frame we're pointing to. */ | |
032d78fe | 679 | #ifdef HAVE_WINDOW_SYSTEM |
1e8324d9 | 680 | if (track && FRAME_WINDOW_P (XFRAME (frame))) |
0aed85f4 KH |
681 | { |
682 | Lisp_Object focus, xfocus; | |
683 | ||
d7266360 | 684 | xfocus = x_get_focus_frame (XFRAME (frame)); |
0aed85f4 KH |
685 | if (FRAMEP (xfocus)) |
686 | { | |
687 | focus = FRAME_FOCUS_FRAME (XFRAME (xfocus)); | |
8d2666fe | 688 | if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ()) |
0aed85f4 KH |
689 | Fredirect_frame_focus (xfocus, frame); |
690 | } | |
691 | } | |
692 | #endif /* HAVE_X_WINDOWS */ | |
693 | #endif /* ! 0 */ | |
a42e9724 | 694 | |
1e8324d9 | 695 | if (!for_deletion && FRAME_HAS_MINIBUF_P (sf)) |
550f0e6a GM |
696 | resize_mini_window (XWINDOW (FRAME_MINIBUF_WINDOW (sf)), 1); |
697 | ||
8d2666fe GM |
698 | selected_frame = frame; |
699 | if (! FRAME_MINIBUF_ONLY_P (XFRAME (selected_frame))) | |
700 | last_nonminibuf_frame = XFRAME (selected_frame); | |
d5e7c279 | 701 | |
f1321dc3 | 702 | Fselect_window (XFRAME (frame)->selected_window, Qnil); |
dc6f92b8 | 703 | |
94674d18 EZ |
704 | #ifndef WINDOWSNT |
705 | /* Make sure to switch the tty color mode to that of the newly | |
706 | selected frame. */ | |
707 | sf = SELECTED_FRAME (); | |
708 | if (FRAME_TERMCAP_P (sf)) | |
709 | { | |
710 | Lisp_Object color_mode_spec, color_mode; | |
711 | ||
712 | color_mode_spec = assq_no_quit (Qtty_color_mode, sf->param_alist); | |
713 | if (CONSP (color_mode_spec)) | |
714 | color_mode = XCDR (color_mode_spec); | |
715 | else | |
716 | color_mode = make_number (0); | |
717 | set_tty_color_mode (sf, color_mode); | |
718 | } | |
719 | #endif /* !WINDOWSNT */ | |
720 | ||
074577b8 | 721 | /* We want to make sure that the next event generates a frame-switch |
eb8c3be9 | 722 | event to the appropriate frame. This seems kludgy to me, but |
074577b8 JB |
723 | before you take it out, make sure that evaluating something like |
724 | (select-window (frame-root-window (new-frame))) doesn't end up | |
725 | with your typing being interpreted in the new frame instead of | |
726 | the one you're actually typing in. */ | |
ef352596 | 727 | internal_last_event_frame = Qnil; |
074577b8 | 728 | |
ff11dfa1 | 729 | return frame; |
dc6f92b8 JB |
730 | } |
731 | ||
20dc6fbb | 732 | DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 1, "e", |
14ff1ee0 PJ |
733 | doc: /* Select the frame FRAME. |
734 | Subsequent editing commands apply to its selected window. | |
735 | The selection of FRAME lasts until the next time the user does | |
736 | something to select a different frame, or until the next time this | |
e4ed805e LT |
737 | function is called. If you are using a window system, the previously |
738 | selected frame may be restored as the selected frame after return to | |
739 | the command loop, because it still may have the window system's input | |
740 | focus. On a text-only terminal, the next redisplay will display FRAME. | |
741 | ||
742 | This function returns FRAME, or nil if FRAME has been deleted. */) | |
20dc6fbb LT |
743 | (frame) |
744 | Lisp_Object frame; | |
0aed85f4 | 745 | { |
1e8324d9 | 746 | return do_switch_frame (frame, 1, 0); |
0aed85f4 KH |
747 | } |
748 | ||
749 | ||
20dc6fbb | 750 | DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 1, "e", |
14ff1ee0 PJ |
751 | doc: /* Handle a switch-frame event EVENT. |
752 | Switch-frame events are usually bound to this function. | |
753 | A switch-frame event tells Emacs that the window manager has requested | |
754 | that the user's events be directed to the frame mentioned in the event. | |
755 | This function selects the selected window of the frame of EVENT. | |
756 | ||
757 | If EVENT is frame object, handle it as if it were a switch-frame event | |
758 | to that frame. */) | |
20dc6fbb LT |
759 | (event) |
760 | Lisp_Object event; | |
0aed85f4 | 761 | { |
6951cd71 KH |
762 | /* Preserve prefix arg that the command loop just cleared. */ |
763 | current_kboard->Vprefix_arg = Vcurrent_prefix_arg; | |
e05169e2 | 764 | call1 (Vrun_hooks, Qmouse_leave_buffer_hook); |
1e8324d9 | 765 | return do_switch_frame (event, 0, 0); |
0aed85f4 KH |
766 | } |
767 | ||
ff11dfa1 | 768 | DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0, |
14ff1ee0 PJ |
769 | doc: /* Return the frame that is now selected. */) |
770 | () | |
dc6f92b8 | 771 | { |
8d2666fe | 772 | return selected_frame; |
dc6f92b8 | 773 | } |
4a7cfafc | 774 | \f |
ff11dfa1 | 775 | DEFUN ("window-frame", Fwindow_frame, Swindow_frame, 1, 1, 0, |
14ff1ee0 PJ |
776 | doc: /* Return the frame object that window WINDOW is on. */) |
777 | (window) | |
dc6f92b8 JB |
778 | Lisp_Object window; |
779 | { | |
b7826503 | 780 | CHECK_LIVE_WINDOW (window); |
ff11dfa1 | 781 | return XWINDOW (window)->frame; |
dc6f92b8 JB |
782 | } |
783 | ||
ba32f2db | 784 | DEFUN ("frame-first-window", Fframe_first_window, Sframe_first_window, 0, 1, 0, |
14ff1ee0 PJ |
785 | doc: /* Returns the topmost, leftmost window of FRAME. |
786 | If omitted, FRAME defaults to the currently selected frame. */) | |
787 | (frame) | |
ba32f2db KH |
788 | Lisp_Object frame; |
789 | { | |
790 | Lisp_Object w; | |
791 | ||
792 | if (NILP (frame)) | |
8d2666fe | 793 | w = SELECTED_FRAME ()->root_window; |
ba32f2db KH |
794 | else |
795 | { | |
b7826503 | 796 | CHECK_LIVE_FRAME (frame); |
ba32f2db KH |
797 | w = XFRAME (frame)->root_window; |
798 | } | |
799 | while (NILP (XWINDOW (w)->buffer)) | |
800 | { | |
801 | if (! NILP (XWINDOW (w)->hchild)) | |
802 | w = XWINDOW (w)->hchild; | |
803 | else if (! NILP (XWINDOW (w)->vchild)) | |
804 | w = XWINDOW (w)->vchild; | |
805 | else | |
806 | abort (); | |
807 | } | |
808 | return w; | |
809 | } | |
810 | ||
5add3885 RS |
811 | DEFUN ("active-minibuffer-window", Factive_minibuffer_window, |
812 | Sactive_minibuffer_window, 0, 0, 0, | |
14ff1ee0 PJ |
813 | doc: /* Return the currently active minibuffer window, or nil if none. */) |
814 | () | |
5add3885 RS |
815 | { |
816 | return minibuf_level ? minibuf_window : Qnil; | |
817 | } | |
818 | ||
ff11dfa1 | 819 | DEFUN ("frame-root-window", Fframe_root_window, Sframe_root_window, 0, 1, 0, |
14ff1ee0 PJ |
820 | doc: /* Returns the root-window of FRAME. |
821 | If omitted, FRAME defaults to the currently selected frame. */) | |
822 | (frame) | |
ff11dfa1 | 823 | Lisp_Object frame; |
dc6f92b8 | 824 | { |
8d2666fe | 825 | Lisp_Object window; |
177c0ea7 | 826 | |
ff11dfa1 | 827 | if (NILP (frame)) |
8d2666fe | 828 | window = SELECTED_FRAME ()->root_window; |
f9898cc6 | 829 | else |
8d2666fe | 830 | { |
b7826503 | 831 | CHECK_LIVE_FRAME (frame); |
8d2666fe GM |
832 | window = XFRAME (frame)->root_window; |
833 | } | |
177c0ea7 | 834 | |
8d2666fe | 835 | return window; |
dc6f92b8 JB |
836 | } |
837 | ||
ff11dfa1 JB |
838 | DEFUN ("frame-selected-window", Fframe_selected_window, |
839 | Sframe_selected_window, 0, 1, 0, | |
14ff1ee0 PJ |
840 | doc: /* Return the selected window of frame object FRAME. |
841 | If omitted, FRAME defaults to the currently selected frame. */) | |
842 | (frame) | |
ff11dfa1 | 843 | Lisp_Object frame; |
dc6f92b8 | 844 | { |
8d2666fe | 845 | Lisp_Object window; |
177c0ea7 | 846 | |
ff11dfa1 | 847 | if (NILP (frame)) |
8d2666fe | 848 | window = SELECTED_FRAME ()->selected_window; |
f9898cc6 | 849 | else |
8d2666fe | 850 | { |
b7826503 | 851 | CHECK_LIVE_FRAME (frame); |
8d2666fe GM |
852 | window = XFRAME (frame)->selected_window; |
853 | } | |
dc6f92b8 | 854 | |
8d2666fe | 855 | return window; |
dc6f92b8 JB |
856 | } |
857 | ||
4a7cfafc RS |
858 | DEFUN ("set-frame-selected-window", Fset_frame_selected_window, |
859 | Sset_frame_selected_window, 2, 2, 0, | |
14ff1ee0 | 860 | doc: /* Set the selected window of frame object FRAME to WINDOW. |
e4ed805e | 861 | Return WINDOW. |
14ff1ee0 PJ |
862 | If FRAME is nil, the selected frame is used. |
863 | If FRAME is the selected frame, this makes WINDOW the selected window. */) | |
864 | (frame, window) | |
4a7cfafc RS |
865 | Lisp_Object frame, window; |
866 | { | |
867 | if (NILP (frame)) | |
8d2666fe | 868 | frame = selected_frame; |
177c0ea7 | 869 | |
b7826503 PJ |
870 | CHECK_LIVE_FRAME (frame); |
871 | CHECK_LIVE_WINDOW (window); | |
4a7cfafc RS |
872 | |
873 | if (! EQ (frame, WINDOW_FRAME (XWINDOW (window)))) | |
874 | error ("In `set-frame-selected-window', WINDOW is not on FRAME"); | |
875 | ||
8d2666fe | 876 | if (EQ (frame, selected_frame)) |
f1321dc3 | 877 | return Fselect_window (window, Qnil); |
4a7cfafc RS |
878 | |
879 | return XFRAME (frame)->selected_window = window; | |
880 | } | |
881 | \f | |
ff11dfa1 | 882 | DEFUN ("frame-list", Fframe_list, Sframe_list, |
dc6f92b8 | 883 | 0, 0, 0, |
14ff1ee0 PJ |
884 | doc: /* Return a list of all frames. */) |
885 | () | |
dc6f92b8 | 886 | { |
d74c1900 GM |
887 | Lisp_Object frames; |
888 | frames = Fcopy_sequence (Vframe_list); | |
6a65b1b5 | 889 | #ifdef HAVE_WINDOW_SYSTEM |
d74c1900 GM |
890 | if (FRAMEP (tip_frame)) |
891 | frames = Fdelq (tip_frame, frames); | |
6a65b1b5 | 892 | #endif |
d74c1900 | 893 | return frames; |
dc6f92b8 JB |
894 | } |
895 | ||
ff11dfa1 | 896 | /* Return the next frame in the frame list after FRAME. |
ff11dfa1 | 897 | If MINIBUF is nil, exclude minibuffer-only frames. |
a9986780 RS |
898 | If MINIBUF is a window, include only its own frame |
899 | and any frame now using that window as the minibuffer. | |
f7af3f7b | 900 | If MINIBUF is `visible', include all visible frames. |
a9986780 | 901 | If MINIBUF is 0, include all visible and iconified frames. |
f7af3f7b RS |
902 | Otherwise, include all frames. */ |
903 | ||
66a9dbbe | 904 | static Lisp_Object |
ff11dfa1 JB |
905 | next_frame (frame, minibuf) |
906 | Lisp_Object frame; | |
f9898cc6 | 907 | Lisp_Object minibuf; |
dc6f92b8 JB |
908 | { |
909 | Lisp_Object tail; | |
910 | int passed = 0; | |
911 | ||
ff11dfa1 JB |
912 | /* There must always be at least one frame in Vframe_list. */ |
913 | if (! CONSP (Vframe_list)) | |
f9898cc6 JB |
914 | abort (); |
915 | ||
dbc4e1c1 JB |
916 | /* If this frame is dead, it won't be in Vframe_list, and we'll loop |
917 | forever. Forestall that. */ | |
b7826503 | 918 | CHECK_LIVE_FRAME (frame); |
dbc4e1c1 | 919 | |
dc6f92b8 | 920 | while (1) |
7539e11f | 921 | for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail)) |
dc6f92b8 | 922 | { |
ab9f008d | 923 | Lisp_Object f; |
d06a8a56 | 924 | |
7539e11f | 925 | f = XCAR (tail); |
06537cc8 RS |
926 | |
927 | if (passed | |
928 | && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame))) | |
d5e7c279 | 929 | { |
d06a8a56 JB |
930 | /* Decide whether this frame is eligible to be returned. */ |
931 | ||
932 | /* If we've looped all the way around without finding any | |
933 | eligible frames, return the original frame. */ | |
934 | if (EQ (f, frame)) | |
935 | return f; | |
936 | ||
937 | /* Let minibuf decide if this frame is acceptable. */ | |
938 | if (NILP (minibuf)) | |
939 | { | |
940 | if (! FRAME_MINIBUF_ONLY_P (XFRAME (f))) | |
941 | return f; | |
942 | } | |
f7af3f7b RS |
943 | else if (EQ (minibuf, Qvisible)) |
944 | { | |
945 | FRAME_SAMPLE_VISIBILITY (XFRAME (f)); | |
946 | if (FRAME_VISIBLE_P (XFRAME (f))) | |
947 | return f; | |
948 | } | |
3780bc22 | 949 | else if (INTEGERP (minibuf) && XINT (minibuf) == 0) |
a9986780 RS |
950 | { |
951 | FRAME_SAMPLE_VISIBILITY (XFRAME (f)); | |
952 | if (FRAME_VISIBLE_P (XFRAME (f)) | |
953 | || FRAME_ICONIFIED_P (XFRAME (f))) | |
954 | return f; | |
955 | } | |
f7af3f7b | 956 | else if (WINDOWP (minibuf)) |
d06a8a56 | 957 | { |
a9986780 | 958 | if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf) |
551645f8 GM |
959 | || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f) |
960 | || EQ (WINDOW_FRAME (XWINDOW (minibuf)), | |
961 | FRAME_FOCUS_FRAME (XFRAME (f)))) | |
d06a8a56 JB |
962 | return f; |
963 | } | |
964 | else | |
ff11dfa1 | 965 | return f; |
d5e7c279 | 966 | } |
dc6f92b8 | 967 | |
d06a8a56 | 968 | if (EQ (frame, f)) |
dc6f92b8 JB |
969 | passed++; |
970 | } | |
971 | } | |
972 | ||
ff11dfa1 | 973 | /* Return the previous frame in the frame list before FRAME. |
ff11dfa1 | 974 | If MINIBUF is nil, exclude minibuffer-only frames. |
a9986780 RS |
975 | If MINIBUF is a window, include only its own frame |
976 | and any frame now using that window as the minibuffer. | |
f7af3f7b | 977 | If MINIBUF is `visible', include all visible frames. |
a9986780 | 978 | If MINIBUF is 0, include all visible and iconified frames. |
f7af3f7b RS |
979 | Otherwise, include all frames. */ |
980 | ||
66a9dbbe | 981 | static Lisp_Object |
ff11dfa1 JB |
982 | prev_frame (frame, minibuf) |
983 | Lisp_Object frame; | |
f9898cc6 | 984 | Lisp_Object minibuf; |
dc6f92b8 JB |
985 | { |
986 | Lisp_Object tail; | |
987 | Lisp_Object prev; | |
988 | ||
ff11dfa1 JB |
989 | /* There must always be at least one frame in Vframe_list. */ |
990 | if (! CONSP (Vframe_list)) | |
f9898cc6 JB |
991 | abort (); |
992 | ||
dc6f92b8 | 993 | prev = Qnil; |
7539e11f | 994 | for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail)) |
f9898cc6 | 995 | { |
ab9f008d | 996 | Lisp_Object f; |
f9898cc6 | 997 | |
7539e11f | 998 | f = XCAR (tail); |
e35d291d | 999 | if (!FRAMEP (f)) |
d06a8a56 | 1000 | abort (); |
f9898cc6 | 1001 | |
d06a8a56 JB |
1002 | if (EQ (frame, f) && !NILP (prev)) |
1003 | return prev; | |
f9898cc6 | 1004 | |
06537cc8 | 1005 | if (FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame))) |
f7af3f7b | 1006 | { |
06537cc8 RS |
1007 | /* Decide whether this frame is eligible to be returned, |
1008 | according to minibuf. */ | |
1009 | if (NILP (minibuf)) | |
1010 | { | |
1011 | if (! FRAME_MINIBUF_ONLY_P (XFRAME (f))) | |
1012 | prev = f; | |
1013 | } | |
1014 | else if (WINDOWP (minibuf)) | |
1015 | { | |
1016 | if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf) | |
551645f8 GM |
1017 | || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f) |
1018 | || EQ (WINDOW_FRAME (XWINDOW (minibuf)), | |
1019 | FRAME_FOCUS_FRAME (XFRAME (f)))) | |
06537cc8 RS |
1020 | prev = f; |
1021 | } | |
1022 | else if (EQ (minibuf, Qvisible)) | |
1023 | { | |
1024 | FRAME_SAMPLE_VISIBILITY (XFRAME (f)); | |
1025 | if (FRAME_VISIBLE_P (XFRAME (f))) | |
1026 | prev = f; | |
1027 | } | |
1028 | else if (XFASTINT (minibuf) == 0) | |
1029 | { | |
1030 | FRAME_SAMPLE_VISIBILITY (XFRAME (f)); | |
1031 | if (FRAME_VISIBLE_P (XFRAME (f)) | |
1032 | || FRAME_ICONIFIED_P (XFRAME (f))) | |
1033 | prev = f; | |
1034 | } | |
1035 | else | |
a9986780 RS |
1036 | prev = f; |
1037 | } | |
f9898cc6 | 1038 | } |
d06a8a56 JB |
1039 | |
1040 | /* We've scanned the entire list. */ | |
1041 | if (NILP (prev)) | |
1042 | /* We went through the whole frame list without finding a single | |
1043 | acceptable frame. Return the original frame. */ | |
1044 | return frame; | |
1045 | else | |
1046 | /* There were no acceptable frames in the list before FRAME; otherwise, | |
1047 | we would have returned directly from the loop. Since PREV is the last | |
1048 | acceptable frame in the list, return it. */ | |
1049 | return prev; | |
dc6f92b8 JB |
1050 | } |
1051 | ||
ef2c57ac | 1052 | |
ff11dfa1 | 1053 | DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0, |
14ff1ee0 PJ |
1054 | doc: /* Return the next frame in the frame list after FRAME. |
1055 | It considers only frames on the same terminal as FRAME. | |
1056 | By default, skip minibuffer-only frames. | |
1057 | If omitted, FRAME defaults to the selected frame. | |
1058 | If optional argument MINIFRAME is nil, exclude minibuffer-only frames. | |
1059 | If MINIFRAME is a window, include only its own frame | |
1060 | and any frame now using that window as the minibuffer. | |
1061 | If MINIFRAME is `visible', include all visible frames. | |
1062 | If MINIFRAME is 0, include all visible and iconified frames. | |
1063 | Otherwise, include all frames. */) | |
1064 | (frame, miniframe) | |
8693ca83 | 1065 | Lisp_Object frame, miniframe; |
dc6f92b8 | 1066 | { |
ff11dfa1 | 1067 | if (NILP (frame)) |
8d2666fe | 1068 | frame = selected_frame; |
177c0ea7 | 1069 | |
b7826503 | 1070 | CHECK_LIVE_FRAME (frame); |
ff11dfa1 | 1071 | return next_frame (frame, miniframe); |
dc6f92b8 | 1072 | } |
dbc4e1c1 | 1073 | |
ef2c57ac | 1074 | DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0, |
14ff1ee0 PJ |
1075 | doc: /* Return the previous frame in the frame list before FRAME. |
1076 | It considers only frames on the same terminal as FRAME. | |
1077 | By default, skip minibuffer-only frames. | |
1078 | If omitted, FRAME defaults to the selected frame. | |
1079 | If optional argument MINIFRAME is nil, exclude minibuffer-only frames. | |
1080 | If MINIFRAME is a window, include only its own frame | |
1081 | and any frame now using that window as the minibuffer. | |
1082 | If MINIFRAME is `visible', include all visible frames. | |
1083 | If MINIFRAME is 0, include all visible and iconified frames. | |
1084 | Otherwise, include all frames. */) | |
1085 | (frame, miniframe) | |
ef2c57ac RM |
1086 | Lisp_Object frame, miniframe; |
1087 | { | |
ef2c57ac | 1088 | if (NILP (frame)) |
8d2666fe | 1089 | frame = selected_frame; |
b7826503 | 1090 | CHECK_LIVE_FRAME (frame); |
ef2c57ac RM |
1091 | return prev_frame (frame, miniframe); |
1092 | } | |
dc6f92b8 | 1093 | \f |
808c0f20 RS |
1094 | /* Return 1 if it is ok to delete frame F; |
1095 | 0 if all frames aside from F are invisible. | |
1096 | (Exception: if F is the terminal frame, and we are using X, return 1.) */ | |
dc6f92b8 | 1097 | |
d56b45eb | 1098 | int |
808c0f20 RS |
1099 | other_visible_frames (f) |
1100 | FRAME_PTR f; | |
1101 | { | |
1102 | /* We know the selected frame is visible, | |
1103 | so if F is some other frame, it can't be the sole visible one. */ | |
8d2666fe | 1104 | if (f == SELECTED_FRAME ()) |
c08c95c7 RS |
1105 | { |
1106 | Lisp_Object frames; | |
1107 | int count = 0; | |
1108 | ||
1109 | for (frames = Vframe_list; | |
1110 | CONSP (frames); | |
7539e11f | 1111 | frames = XCDR (frames)) |
c08c95c7 | 1112 | { |
ab9f008d | 1113 | Lisp_Object this; |
c08c95c7 | 1114 | |
7539e11f | 1115 | this = XCAR (frames); |
808c0f20 RS |
1116 | /* Verify that the frame's window still exists |
1117 | and we can still talk to it. And note any recent change | |
1118 | in visibility. */ | |
032d78fe GV |
1119 | #ifdef HAVE_WINDOW_SYSTEM |
1120 | if (FRAME_WINDOW_P (XFRAME (this))) | |
5e7b7c5b | 1121 | { |
b0509a40 | 1122 | x_sync (XFRAME (this)); |
5e7b7c5b RS |
1123 | FRAME_SAMPLE_VISIBILITY (XFRAME (this)); |
1124 | } | |
1125 | #endif | |
1126 | ||
c08c95c7 RS |
1127 | if (FRAME_VISIBLE_P (XFRAME (this)) |
1128 | || FRAME_ICONIFIED_P (XFRAME (this)) | |
1129 | /* Allow deleting the terminal frame when at least | |
1130 | one X frame exists! */ | |
032d78fe | 1131 | || (FRAME_WINDOW_P (XFRAME (this)) && !FRAME_WINDOW_P (f))) |
c08c95c7 RS |
1132 | count++; |
1133 | } | |
808c0f20 | 1134 | return count > 1; |
c08c95c7 | 1135 | } |
808c0f20 RS |
1136 | return 1; |
1137 | } | |
1138 | ||
1139 | DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "", | |
14ff1ee0 PJ |
1140 | doc: /* Delete FRAME, permanently eliminating it from use. |
1141 | If omitted, FRAME defaults to the selected frame. | |
1142 | A frame may not be deleted if its minibuffer is used by other frames. | |
1143 | Normally, you may not delete a frame if all other frames are invisible, | |
1144 | but if the second optional argument FORCE is non-nil, you may do so. | |
1145 | ||
cd1d850f JPW |
1146 | This function runs `delete-frame-functions' before actually deleting the |
1147 | frame, unless the frame is a tooltip. | |
1148 | The functions are run with one arg, the frame to be deleted. */) | |
14ff1ee0 | 1149 | (frame, force) |
808c0f20 RS |
1150 | Lisp_Object frame, force; |
1151 | { | |
1152 | struct frame *f; | |
8d2666fe | 1153 | struct frame *sf = SELECTED_FRAME (); |
99b92e64 | 1154 | int minibuffer_selected; |
808c0f20 RS |
1155 | |
1156 | if (EQ (frame, Qnil)) | |
1157 | { | |
8d2666fe | 1158 | f = sf; |
2d80a27a | 1159 | XSETFRAME (frame, f); |
808c0f20 RS |
1160 | } |
1161 | else | |
1162 | { | |
b7826503 | 1163 | CHECK_FRAME (frame); |
808c0f20 RS |
1164 | f = XFRAME (frame); |
1165 | } | |
1166 | ||
1167 | if (! FRAME_LIVE_P (f)) | |
1168 | return Qnil; | |
1169 | ||
83a96b4d | 1170 | if (NILP (force) && !other_visible_frames (f) |
e0f712ba | 1171 | #ifdef MAC_OS8 |
83a96b4d AC |
1172 | /* Terminal frame deleted before any other visible frames are |
1173 | created. */ | |
d5db4077 | 1174 | && strcmp (SDATA (f->name), "F1") != 0 |
83a96b4d AC |
1175 | #endif |
1176 | ) | |
808c0f20 | 1177 | error ("Attempt to delete the sole visible or iconified frame"); |
d5e7c279 | 1178 | |
00c5fd51 RS |
1179 | #if 0 |
1180 | /* This is a nice idea, but x_connection_closed needs to be able | |
1181 | to delete the last frame, if it is gone. */ | |
7539e11f | 1182 | if (NILP (XCDR (Vframe_list))) |
e9687ee8 | 1183 | error ("Attempt to delete the only frame"); |
00c5fd51 | 1184 | #endif |
e9687ee8 | 1185 | |
ff11dfa1 JB |
1186 | /* Does this frame have a minibuffer, and is it the surrogate |
1187 | minibuffer for any other frame? */ | |
fd0c2bd1 | 1188 | if (FRAME_HAS_MINIBUF_P (XFRAME (frame))) |
dc6f92b8 | 1189 | { |
ff11dfa1 | 1190 | Lisp_Object frames; |
1113d9db | 1191 | |
ff11dfa1 JB |
1192 | for (frames = Vframe_list; |
1193 | CONSP (frames); | |
7539e11f | 1194 | frames = XCDR (frames)) |
1113d9db | 1195 | { |
7a8cc307 | 1196 | Lisp_Object this; |
7539e11f | 1197 | this = XCAR (frames); |
1113d9db | 1198 | |
ff11dfa1 JB |
1199 | if (! EQ (this, frame) |
1200 | && EQ (frame, | |
7a8cc307 RS |
1201 | WINDOW_FRAME (XWINDOW |
1202 | (FRAME_MINIBUF_WINDOW (XFRAME (this)))))) | |
ff11dfa1 | 1203 | error ("Attempt to delete a surrogate minibuffer frame"); |
1113d9db | 1204 | } |
dc6f92b8 JB |
1205 | } |
1206 | ||
cd1d850f JPW |
1207 | /* Run `delete-frame-functions' unless frame is a tooltip. */ |
1208 | if (!NILP (Vrun_hooks) | |
1209 | && NILP (Fframe_parameter (frame, intern ("tooltip")))) | |
0e662342 GM |
1210 | { |
1211 | Lisp_Object args[2]; | |
cd1d850f | 1212 | args[0] = intern ("delete-frame-functions"); |
0e662342 GM |
1213 | args[1] = frame; |
1214 | Frun_hook_with_args (2, args); | |
1215 | } | |
1216 | ||
99b92e64 RS |
1217 | minibuffer_selected = EQ (minibuf_window, selected_window); |
1218 | ||
ff11dfa1 | 1219 | /* Don't let the frame remain selected. */ |
8d2666fe | 1220 | if (f == sf) |
06537cc8 RS |
1221 | { |
1222 | Lisp_Object tail, frame1; | |
1223 | ||
1224 | /* Look for another visible frame on the same terminal. */ | |
1225 | frame1 = next_frame (frame, Qvisible); | |
1226 | ||
1227 | /* If there is none, find *some* other frame. */ | |
1228 | if (NILP (frame1) || EQ (frame1, frame)) | |
1229 | { | |
1230 | FOR_EACH_FRAME (tail, frame1) | |
1231 | { | |
1232 | if (! EQ (frame, frame1)) | |
1233 | break; | |
1234 | } | |
1235 | } | |
1236 | ||
1e8324d9 | 1237 | do_switch_frame (frame1, 0, 1); |
79a65b7f | 1238 | sf = SELECTED_FRAME (); |
06537cc8 | 1239 | } |
dc6f92b8 | 1240 | |
ff11dfa1 JB |
1241 | /* Don't allow minibuf_window to remain on a deleted frame. */ |
1242 | if (EQ (f->minibuffer_window, minibuf_window)) | |
dc6f92b8 | 1243 | { |
8d2666fe | 1244 | Fset_window_buffer (sf->minibuffer_window, |
5af5757b | 1245 | XWINDOW (minibuf_window)->buffer, Qnil); |
8d2666fe | 1246 | minibuf_window = sf->minibuffer_window; |
99b92e64 RS |
1247 | |
1248 | /* If the dying minibuffer window was selected, | |
1249 | select the new one. */ | |
1250 | if (minibuffer_selected) | |
f1321dc3 | 1251 | Fselect_window (minibuf_window, Qnil); |
dc6f92b8 JB |
1252 | } |
1253 | ||
130adcb7 EZ |
1254 | /* Don't let echo_area_window to remain on a deleted frame. */ |
1255 | if (EQ (f->minibuffer_window, echo_area_window)) | |
1256 | echo_area_window = sf->minibuffer_window; | |
1257 | ||
bb2a0a65 RS |
1258 | /* Clear any X selections for this frame. */ |
1259 | #ifdef HAVE_X_WINDOWS | |
1260 | if (FRAME_X_P (f)) | |
1261 | x_clear_frame_selections (f); | |
1262 | #endif | |
f706a7b2 YM |
1263 | #ifdef MAC_OS |
1264 | if (FRAME_MAC_P (f)) | |
1265 | x_clear_frame_selections (f); | |
1266 | #endif | |
bb2a0a65 | 1267 | |
177c0ea7 JB |
1268 | /* Free glyphs. |
1269 | This function must be called before the window tree of the | |
18082e2d GM |
1270 | frame is deleted because windows contain dynamically allocated |
1271 | memory. */ | |
1272 | free_glyphs (f); | |
1273 | ||
4a88b3b0 JB |
1274 | /* Mark all the windows that used to be on FRAME as deleted, and then |
1275 | remove the reference to them. */ | |
1276 | delete_all_subwindows (XWINDOW (f->root_window)); | |
1277 | f->root_window = Qnil; | |
1278 | ||
ff11dfa1 | 1279 | Vframe_list = Fdelq (frame, Vframe_list); |
a42e9724 | 1280 | FRAME_SET_VISIBLE (f, 0); |
dc6f92b8 | 1281 | |
60a8823e | 1282 | if (f->namebuf) |
18082e2d | 1283 | xfree (f->namebuf); |
96f09305 JD |
1284 | if (f->decode_mode_spec_buffer) |
1285 | xfree (f->decode_mode_spec_buffer); | |
d2bee99e | 1286 | if (FRAME_INSERT_COST (f)) |
18082e2d | 1287 | xfree (FRAME_INSERT_COST (f)); |
d2bee99e | 1288 | if (FRAME_DELETEN_COST (f)) |
18082e2d | 1289 | xfree (FRAME_DELETEN_COST (f)); |
d2bee99e | 1290 | if (FRAME_INSERTN_COST (f)) |
18082e2d | 1291 | xfree (FRAME_INSERTN_COST (f)); |
d2bee99e | 1292 | if (FRAME_DELETE_COST (f)) |
18082e2d | 1293 | xfree (FRAME_DELETE_COST (f)); |
25734faf | 1294 | if (FRAME_MESSAGE_BUF (f)) |
18082e2d | 1295 | xfree (FRAME_MESSAGE_BUF (f)); |
d2bee99e | 1296 | |
8678b9cc JB |
1297 | /* Since some events are handled at the interrupt level, we may get |
1298 | an event for f at any time; if we zero out the frame's display | |
1299 | now, then we may trip up the event-handling code. Instead, we'll | |
1300 | promise that the display of the frame must be valid until we have | |
1301 | called the window-system-dependent frame destruction routine. */ | |
dbc4e1c1 JB |
1302 | |
1303 | /* I think this should be done with a hook. */ | |
032d78fe GV |
1304 | #ifdef HAVE_WINDOW_SYSTEM |
1305 | if (FRAME_WINDOW_P (f)) | |
8678b9cc | 1306 | x_destroy_window (f); |
d5e7c279 JB |
1307 | #endif |
1308 | ||
7556890b | 1309 | f->output_data.nothing = 0; |
8678b9cc | 1310 | |
ff11dfa1 | 1311 | /* If we've deleted the last_nonminibuf_frame, then try to find |
d5e7c279 | 1312 | another one. */ |
ff11dfa1 | 1313 | if (f == last_nonminibuf_frame) |
d5e7c279 | 1314 | { |
ff11dfa1 | 1315 | Lisp_Object frames; |
1113d9db | 1316 | |
ff11dfa1 | 1317 | last_nonminibuf_frame = 0; |
d5e7c279 | 1318 | |
ff11dfa1 JB |
1319 | for (frames = Vframe_list; |
1320 | CONSP (frames); | |
7539e11f | 1321 | frames = XCDR (frames)) |
d5e7c279 | 1322 | { |
7539e11f | 1323 | f = XFRAME (XCAR (frames)); |
ff11dfa1 | 1324 | if (!FRAME_MINIBUF_ONLY_P (f)) |
d5e7c279 | 1325 | { |
ff11dfa1 | 1326 | last_nonminibuf_frame = f; |
d5e7c279 JB |
1327 | break; |
1328 | } | |
1329 | } | |
1330 | } | |
dc6f92b8 | 1331 | |
8ceb7434 RS |
1332 | /* If there's no other frame on the same kboard, get out of |
1333 | single-kboard state if we're in it for this kboard. */ | |
1334 | { | |
1335 | Lisp_Object frames; | |
1336 | /* Some frame we found on the same kboard, or nil if there are none. */ | |
1337 | Lisp_Object frame_on_same_kboard; | |
1338 | ||
1339 | frame_on_same_kboard = Qnil; | |
1340 | ||
1341 | for (frames = Vframe_list; | |
1342 | CONSP (frames); | |
1343 | frames = XCDR (frames)) | |
1344 | { | |
1345 | Lisp_Object this; | |
1346 | struct frame *f1; | |
1347 | ||
1348 | this = XCAR (frames); | |
1349 | if (!FRAMEP (this)) | |
1350 | abort (); | |
1351 | f1 = XFRAME (this); | |
1352 | ||
1353 | if (FRAME_KBOARD (f) == FRAME_KBOARD (f1)) | |
1354 | frame_on_same_kboard = this; | |
1355 | } | |
1356 | ||
1357 | if (NILP (frame_on_same_kboard)) | |
1358 | not_single_kboard_state (FRAME_KBOARD (f)); | |
1359 | } | |
1360 | ||
1361 | ||
c4c6d073 KH |
1362 | /* If we've deleted this keyboard's default_minibuffer_frame, try to |
1363 | find another one. Prefer minibuffer-only frames, but also notice | |
1364 | frames with other windows. */ | |
c60f3a6a | 1365 | if (EQ (frame, FRAME_KBOARD (f)->Vdefault_minibuffer_frame)) |
1113d9db | 1366 | { |
ff11dfa1 | 1367 | Lisp_Object frames; |
1113d9db | 1368 | |
ff11dfa1 | 1369 | /* The last frame we saw with a minibuffer, minibuffer-only or not. */ |
ab9f008d | 1370 | Lisp_Object frame_with_minibuf; |
32fda9ba RS |
1371 | /* Some frame we found on the same kboard, or nil if there are none. */ |
1372 | Lisp_Object frame_on_same_kboard; | |
1113d9db | 1373 | |
32fda9ba | 1374 | frame_on_same_kboard = Qnil; |
ab9f008d | 1375 | frame_with_minibuf = Qnil; |
32fda9ba | 1376 | |
ff11dfa1 JB |
1377 | for (frames = Vframe_list; |
1378 | CONSP (frames); | |
7539e11f | 1379 | frames = XCDR (frames)) |
1113d9db | 1380 | { |
ab9f008d | 1381 | Lisp_Object this; |
c4c6d073 | 1382 | struct frame *f1; |
1113d9db | 1383 | |
7539e11f | 1384 | this = XCAR (frames); |
e35d291d | 1385 | if (!FRAMEP (this)) |
1113d9db | 1386 | abort (); |
c4c6d073 | 1387 | f1 = XFRAME (this); |
1113d9db | 1388 | |
c4c6d073 KH |
1389 | /* Consider only frames on the same kboard |
1390 | and only those with minibuffers. */ | |
1391 | if (FRAME_KBOARD (f) == FRAME_KBOARD (f1) | |
1392 | && FRAME_HAS_MINIBUF_P (f1)) | |
1113d9db | 1393 | { |
ff11dfa1 | 1394 | frame_with_minibuf = this; |
c4c6d073 | 1395 | if (FRAME_MINIBUF_ONLY_P (f1)) |
1113d9db JB |
1396 | break; |
1397 | } | |
32fda9ba RS |
1398 | |
1399 | if (FRAME_KBOARD (f) == FRAME_KBOARD (f1)) | |
1400 | frame_on_same_kboard = this; | |
1113d9db JB |
1401 | } |
1402 | ||
32fda9ba RS |
1403 | if (!NILP (frame_on_same_kboard)) |
1404 | { | |
1405 | /* We know that there must be some frame with a minibuffer out | |
1406 | there. If this were not true, all of the frames present | |
1407 | would have to be minibufferless, which implies that at some | |
1408 | point their minibuffer frames must have been deleted, but | |
1409 | that is prohibited at the top; you can't delete surrogate | |
1410 | minibuffer frames. */ | |
1411 | if (NILP (frame_with_minibuf)) | |
1412 | abort (); | |
1113d9db | 1413 | |
32fda9ba RS |
1414 | FRAME_KBOARD (f)->Vdefault_minibuffer_frame = frame_with_minibuf; |
1415 | } | |
1416 | else | |
1417 | /* No frames left on this kboard--say no minibuffer either. */ | |
1418 | FRAME_KBOARD (f)->Vdefault_minibuffer_frame = Qnil; | |
1113d9db JB |
1419 | } |
1420 | ||
e681c92a RS |
1421 | /* Cause frame titles to update--necessary if we now have just one frame. */ |
1422 | update_mode_lines = 1; | |
1423 | ||
dc6f92b8 JB |
1424 | return Qnil; |
1425 | } | |
1426 | \f | |
1427 | /* Return mouse position in character cell units. */ | |
1428 | ||
f9898cc6 | 1429 | DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0, |
14ff1ee0 PJ |
1430 | doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position. |
1431 | The position is given in character cells, where (0, 0) is the | |
1432 | upper-left corner. | |
1433 | If Emacs is running on a mouseless terminal or hasn't been programmed | |
1434 | to read the mouse position, it returns the selected frame for FRAME | |
1435 | and nil for X and Y. | |
1436 | If `mouse-position-function' is non-nil, `mouse-position' calls it, | |
1437 | passing the normal return value to that function as an argument, | |
1438 | and returns whatever that function returns. */) | |
1439 | () | |
dc6f92b8 | 1440 | { |
ff11dfa1 | 1441 | FRAME_PTR f; |
dbc4e1c1 | 1442 | Lisp_Object lispy_dummy; |
fd2777e0 | 1443 | enum scroll_bar_part party_dummy; |
beb0bc36 | 1444 | Lisp_Object x, y, retval; |
5384466a | 1445 | int col, row; |
dbc4e1c1 | 1446 | unsigned long long_dummy; |
cb2255b3 | 1447 | struct gcpro gcpro1; |
dc6f92b8 | 1448 | |
8d2666fe | 1449 | f = SELECTED_FRAME (); |
c5074d8c RS |
1450 | x = y = Qnil; |
1451 | ||
f443c170 | 1452 | #ifdef HAVE_MOUSE |
c5074d8c | 1453 | /* It's okay for the hook to refrain from storing anything. */ |
f9898cc6 | 1454 | if (mouse_position_hook) |
66e827dc | 1455 | (*mouse_position_hook) (&f, -1, |
dbc4e1c1 JB |
1456 | &lispy_dummy, &party_dummy, |
1457 | &x, &y, | |
1458 | &long_dummy); | |
76db7eb4 KH |
1459 | if (! NILP (x)) |
1460 | { | |
1461 | col = XINT (x); | |
1462 | row = XINT (y); | |
8126c3b4 | 1463 | pixel_to_glyph_coords (f, col, row, &col, &row, NULL, 1); |
76db7eb4 KH |
1464 | XSETINT (x, col); |
1465 | XSETINT (y, row); | |
1466 | } | |
f443c170 | 1467 | #endif |
2d80a27a | 1468 | XSETFRAME (lispy_dummy, f); |
beb0bc36 | 1469 | retval = Fcons (lispy_dummy, Fcons (x, y)); |
cb2255b3 | 1470 | GCPRO1 (retval); |
beb0bc36 | 1471 | if (!NILP (Vmouse_position_function)) |
cb2255b3 GM |
1472 | retval = call1 (Vmouse_position_function, retval); |
1473 | RETURN_UNGCPRO (retval); | |
dc6f92b8 JB |
1474 | } |
1475 | ||
152e6c70 RS |
1476 | DEFUN ("mouse-pixel-position", Fmouse_pixel_position, |
1477 | Smouse_pixel_position, 0, 0, 0, | |
14ff1ee0 PJ |
1478 | doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position. |
1479 | The position is given in pixel units, where (0, 0) is the | |
1480 | upper-left corner. | |
1481 | If Emacs is running on a mouseless terminal or hasn't been programmed | |
1482 | to read the mouse position, it returns the selected frame for FRAME | |
1483 | and nil for X and Y. */) | |
1484 | () | |
152e6c70 RS |
1485 | { |
1486 | FRAME_PTR f; | |
1487 | Lisp_Object lispy_dummy; | |
1488 | enum scroll_bar_part party_dummy; | |
1489 | Lisp_Object x, y; | |
152e6c70 RS |
1490 | unsigned long long_dummy; |
1491 | ||
8d2666fe | 1492 | f = SELECTED_FRAME (); |
152e6c70 RS |
1493 | x = y = Qnil; |
1494 | ||
0c5c1cf7 | 1495 | #ifdef HAVE_MOUSE |
152e6c70 RS |
1496 | /* It's okay for the hook to refrain from storing anything. */ |
1497 | if (mouse_position_hook) | |
66e827dc | 1498 | (*mouse_position_hook) (&f, -1, |
152e6c70 RS |
1499 | &lispy_dummy, &party_dummy, |
1500 | &x, &y, | |
1501 | &long_dummy); | |
0c5c1cf7 | 1502 | #endif |
2d80a27a | 1503 | XSETFRAME (lispy_dummy, f); |
152e6c70 RS |
1504 | return Fcons (lispy_dummy, Fcons (x, y)); |
1505 | } | |
1506 | ||
dc6f92b8 | 1507 | DEFUN ("set-mouse-position", Fset_mouse_position, Sset_mouse_position, 3, 3, 0, |
14ff1ee0 PJ |
1508 | doc: /* Move the mouse pointer to the center of character cell (X,Y) in FRAME. |
1509 | Coordinates are relative to the frame, not a window, | |
1510 | so the coordinates of the top left character in the frame | |
1511 | may be nonzero due to left-hand scroll bars or the menu bar. | |
1512 | ||
1513 | This function is a no-op for an X frame that is not visible. | |
1514 | If you have just created a frame, you must wait for it to become visible | |
1515 | before calling this function on it, like this. | |
1516 | (while (not (frame-visible-p frame)) (sleep-for .5)) */) | |
ff11dfa1 JB |
1517 | (frame, x, y) |
1518 | Lisp_Object frame, x, y; | |
dc6f92b8 | 1519 | { |
b7826503 PJ |
1520 | CHECK_LIVE_FRAME (frame); |
1521 | CHECK_NUMBER (x); | |
1522 | CHECK_NUMBER (y); | |
dc6f92b8 | 1523 | |
dbc4e1c1 | 1524 | /* I think this should be done with a hook. */ |
032d78fe GV |
1525 | #ifdef HAVE_WINDOW_SYSTEM |
1526 | if (FRAME_WINDOW_P (XFRAME (frame))) | |
d19be8a9 | 1527 | /* Warping the mouse will cause enternotify and focus events. */ |
d4d76014 | 1528 | x_set_mouse_position (XFRAME (frame), XINT (x), XINT (y)); |
bb221971 | 1529 | #else |
be625e00 | 1530 | #if defined (MSDOS) && defined (HAVE_MOUSE) |
bb221971 RS |
1531 | if (FRAME_MSDOS_P (XFRAME (frame))) |
1532 | { | |
20dc6fbb | 1533 | Fselect_frame (frame); |
bb221971 RS |
1534 | mouse_moveto (XINT (x), XINT (y)); |
1535 | } | |
1536 | #endif | |
dc6f92b8 JB |
1537 | #endif |
1538 | ||
1539 | return Qnil; | |
1540 | } | |
152e6c70 RS |
1541 | |
1542 | DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position, | |
1543 | Sset_mouse_pixel_position, 3, 3, 0, | |
14ff1ee0 PJ |
1544 | doc: /* Move the mouse pointer to pixel position (X,Y) in FRAME. |
1545 | Note, this is a no-op for an X frame that is not visible. | |
1546 | If you have just created a frame, you must wait for it to become visible | |
1547 | before calling this function on it, like this. | |
1548 | (while (not (frame-visible-p frame)) (sleep-for .5)) */) | |
152e6c70 RS |
1549 | (frame, x, y) |
1550 | Lisp_Object frame, x, y; | |
1551 | { | |
b7826503 PJ |
1552 | CHECK_LIVE_FRAME (frame); |
1553 | CHECK_NUMBER (x); | |
1554 | CHECK_NUMBER (y); | |
152e6c70 RS |
1555 | |
1556 | /* I think this should be done with a hook. */ | |
032d78fe GV |
1557 | #ifdef HAVE_WINDOW_SYSTEM |
1558 | if (FRAME_WINDOW_P (XFRAME (frame))) | |
d19be8a9 | 1559 | /* Warping the mouse will cause enternotify and focus events. */ |
d4d76014 | 1560 | x_set_mouse_pixel_position (XFRAME (frame), XINT (x), XINT (y)); |
bb221971 | 1561 | #else |
be625e00 | 1562 | #if defined (MSDOS) && defined (HAVE_MOUSE) |
bb221971 RS |
1563 | if (FRAME_MSDOS_P (XFRAME (frame))) |
1564 | { | |
20dc6fbb | 1565 | Fselect_frame (frame); |
bb221971 RS |
1566 | mouse_moveto (XINT (x), XINT (y)); |
1567 | } | |
1568 | #endif | |
152e6c70 RS |
1569 | #endif |
1570 | ||
1571 | return Qnil; | |
1572 | } | |
dc6f92b8 | 1573 | \f |
98ce1622 RS |
1574 | static void make_frame_visible_1 P_ ((Lisp_Object)); |
1575 | ||
ff11dfa1 | 1576 | DEFUN ("make-frame-visible", Fmake_frame_visible, Smake_frame_visible, |
fc25d15d | 1577 | 0, 1, "", |
14ff1ee0 PJ |
1578 | doc: /* Make the frame FRAME visible (assuming it is an X window). |
1579 | If omitted, FRAME defaults to the currently selected frame. */) | |
1580 | (frame) | |
ff11dfa1 | 1581 | Lisp_Object frame; |
dc6f92b8 | 1582 | { |
1aa66088 | 1583 | if (NILP (frame)) |
8d2666fe | 1584 | frame = selected_frame; |
1aa66088 | 1585 | |
b7826503 | 1586 | CHECK_LIVE_FRAME (frame); |
dc6f92b8 | 1587 | |
dbc4e1c1 | 1588 | /* I think this should be done with a hook. */ |
032d78fe GV |
1589 | #ifdef HAVE_WINDOW_SYSTEM |
1590 | if (FRAME_WINDOW_P (XFRAME (frame))) | |
02ff9dd5 RS |
1591 | { |
1592 | FRAME_SAMPLE_VISIBILITY (XFRAME (frame)); | |
1593 | x_make_frame_visible (XFRAME (frame)); | |
1594 | } | |
fd0c2bd1 | 1595 | #endif |
dc6f92b8 | 1596 | |
98ce1622 RS |
1597 | make_frame_visible_1 (XFRAME (frame)->root_window); |
1598 | ||
d19be8a9 | 1599 | /* Make menu bar update for the Buffers and Frames menus. */ |
565620a5 RS |
1600 | windows_or_buffers_changed++; |
1601 | ||
ff11dfa1 | 1602 | return frame; |
dc6f92b8 JB |
1603 | } |
1604 | ||
98ce1622 RS |
1605 | /* Update the display_time slot of the buffers shown in WINDOW |
1606 | and all its descendents. */ | |
1607 | ||
1608 | static void | |
1609 | make_frame_visible_1 (window) | |
1610 | Lisp_Object window; | |
1611 | { | |
1612 | struct window *w; | |
1613 | ||
1614 | for (;!NILP (window); window = w->next) | |
1615 | { | |
1616 | w = XWINDOW (window); | |
1617 | ||
1618 | if (!NILP (w->buffer)) | |
1619 | XBUFFER (w->buffer)->display_time = Fcurrent_time (); | |
1620 | ||
1621 | if (!NILP (w->vchild)) | |
1622 | make_frame_visible_1 (w->vchild); | |
1623 | if (!NILP (w->hchild)) | |
1624 | make_frame_visible_1 (w->hchild); | |
1625 | } | |
1626 | } | |
1627 | ||
ff11dfa1 | 1628 | DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible, |
808c0f20 | 1629 | 0, 2, "", |
14ff1ee0 PJ |
1630 | doc: /* Make the frame FRAME invisible (assuming it is an X window). |
1631 | If omitted, FRAME defaults to the currently selected frame. | |
1632 | Normally you may not make FRAME invisible if all other frames are invisible, | |
1633 | but if the second optional argument FORCE is non-nil, you may do so. */) | |
808c0f20 RS |
1634 | (frame, force) |
1635 | Lisp_Object frame, force; | |
dc6f92b8 | 1636 | { |
1aa66088 | 1637 | if (NILP (frame)) |
8d2666fe | 1638 | frame = selected_frame; |
1aa66088 | 1639 | |
b7826503 | 1640 | CHECK_LIVE_FRAME (frame); |
dc6f92b8 | 1641 | |
808c0f20 RS |
1642 | if (NILP (force) && !other_visible_frames (XFRAME (frame))) |
1643 | error ("Attempt to make invisible the sole visible or iconified frame"); | |
1644 | ||
3d378fdf | 1645 | #if 0 /* This isn't logically necessary, and it can do GC. */ |
9c394f17 | 1646 | /* Don't let the frame remain selected. */ |
8d2666fe | 1647 | if (EQ (frame, selected_frame)) |
1e8324d9 | 1648 | do_switch_frame (next_frame (frame, Qt), 0, 0) |
3d378fdf | 1649 | #endif |
9c394f17 RS |
1650 | |
1651 | /* Don't allow minibuf_window to remain on a deleted frame. */ | |
1652 | if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window)) | |
1653 | { | |
8d2666fe GM |
1654 | struct frame *sf = XFRAME (selected_frame); |
1655 | Fset_window_buffer (sf->minibuffer_window, | |
5af5757b | 1656 | XWINDOW (minibuf_window)->buffer, Qnil); |
8d2666fe | 1657 | minibuf_window = sf->minibuffer_window; |
9c394f17 RS |
1658 | } |
1659 | ||
dbc4e1c1 | 1660 | /* I think this should be done with a hook. */ |
032d78fe GV |
1661 | #ifdef HAVE_WINDOW_SYSTEM |
1662 | if (FRAME_WINDOW_P (XFRAME (frame))) | |
ff11dfa1 | 1663 | x_make_frame_invisible (XFRAME (frame)); |
fd0c2bd1 | 1664 | #endif |
dc6f92b8 | 1665 | |
d19be8a9 | 1666 | /* Make menu bar update for the Buffers and Frames menus. */ |
565620a5 RS |
1667 | windows_or_buffers_changed++; |
1668 | ||
dc6f92b8 JB |
1669 | return Qnil; |
1670 | } | |
1671 | ||
ff11dfa1 | 1672 | DEFUN ("iconify-frame", Ficonify_frame, Siconify_frame, |
1aa66088 | 1673 | 0, 1, "", |
14ff1ee0 PJ |
1674 | doc: /* Make the frame FRAME into an icon. |
1675 | If omitted, FRAME defaults to the currently selected frame. */) | |
ff11dfa1 JB |
1676 | (frame) |
1677 | Lisp_Object frame; | |
dc6f92b8 | 1678 | { |
1aa66088 | 1679 | if (NILP (frame)) |
8d2666fe | 1680 | frame = selected_frame; |
177c0ea7 | 1681 | |
b7826503 | 1682 | CHECK_LIVE_FRAME (frame); |
dc6f92b8 | 1683 | |
3d378fdf | 1684 | #if 0 /* This isn't logically necessary, and it can do GC. */ |
9c394f17 | 1685 | /* Don't let the frame remain selected. */ |
8d2666fe | 1686 | if (EQ (frame, selected_frame)) |
20dc6fbb | 1687 | Fhandle_switch_frame (next_frame (frame, Qt)); |
3d378fdf | 1688 | #endif |
9c394f17 RS |
1689 | |
1690 | /* Don't allow minibuf_window to remain on a deleted frame. */ | |
1691 | if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window)) | |
1692 | { | |
8d2666fe GM |
1693 | struct frame *sf = XFRAME (selected_frame); |
1694 | Fset_window_buffer (sf->minibuffer_window, | |
5af5757b | 1695 | XWINDOW (minibuf_window)->buffer, Qnil); |
8d2666fe | 1696 | minibuf_window = sf->minibuffer_window; |
9c394f17 RS |
1697 | } |
1698 | ||
dbc4e1c1 | 1699 | /* I think this should be done with a hook. */ |
032d78fe GV |
1700 | #ifdef HAVE_WINDOW_SYSTEM |
1701 | if (FRAME_WINDOW_P (XFRAME (frame))) | |
ff11dfa1 | 1702 | x_iconify_frame (XFRAME (frame)); |
fd0c2bd1 | 1703 | #endif |
dc6f92b8 | 1704 | |
d19be8a9 | 1705 | /* Make menu bar update for the Buffers and Frames menus. */ |
565620a5 RS |
1706 | windows_or_buffers_changed++; |
1707 | ||
dc6f92b8 JB |
1708 | return Qnil; |
1709 | } | |
1710 | ||
ff11dfa1 | 1711 | DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p, |
dc6f92b8 | 1712 | 1, 1, 0, |
14ff1ee0 PJ |
1713 | doc: /* Return t if FRAME is now \"visible\" (actually in use for display). |
1714 | A frame that is not \"visible\" is not updated and, if it works through | |
1715 | a window system, it may not show at all. | |
e4ed805e LT |
1716 | Return the symbol `icon' if frame is visible only as an icon. |
1717 | ||
1718 | On a text-only terminal, all frames are considered visible, whether | |
1719 | they are currently being displayed or not, and this function returns t | |
1720 | for all frames. */) | |
14ff1ee0 | 1721 | (frame) |
ff11dfa1 | 1722 | Lisp_Object frame; |
dc6f92b8 | 1723 | { |
b7826503 | 1724 | CHECK_LIVE_FRAME (frame); |
dc6f92b8 | 1725 | |
5c044f55 RS |
1726 | FRAME_SAMPLE_VISIBILITY (XFRAME (frame)); |
1727 | ||
a42e9724 | 1728 | if (FRAME_VISIBLE_P (XFRAME (frame))) |
dc6f92b8 | 1729 | return Qt; |
a42e9724 | 1730 | if (FRAME_ICONIFIED_P (XFRAME (frame))) |
fd0c2bd1 | 1731 | return Qicon; |
dc6f92b8 JB |
1732 | return Qnil; |
1733 | } | |
1734 | ||
ff11dfa1 | 1735 | DEFUN ("visible-frame-list", Fvisible_frame_list, Svisible_frame_list, |
dc6f92b8 | 1736 | 0, 0, 0, |
14ff1ee0 | 1737 | doc: /* Return a list of all frames now \"visible\" (being updated). */) |
dc6f92b8 JB |
1738 | () |
1739 | { | |
ff11dfa1 JB |
1740 | Lisp_Object tail, frame; |
1741 | struct frame *f; | |
dc6f92b8 JB |
1742 | Lisp_Object value; |
1743 | ||
1744 | value = Qnil; | |
7539e11f | 1745 | for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail)) |
dc6f92b8 | 1746 | { |
7539e11f | 1747 | frame = XCAR (tail); |
e35d291d | 1748 | if (!FRAMEP (frame)) |
dc6f92b8 | 1749 | continue; |
ff11dfa1 | 1750 | f = XFRAME (frame); |
a42e9724 | 1751 | if (FRAME_VISIBLE_P (f)) |
ff11dfa1 | 1752 | value = Fcons (frame, value); |
dc6f92b8 JB |
1753 | } |
1754 | return value; | |
1755 | } | |
d5e7c279 JB |
1756 | |
1757 | ||
e518d5e1 | 1758 | DEFUN ("raise-frame", Fraise_frame, Sraise_frame, 0, 1, "", |
14ff1ee0 | 1759 | doc: /* Bring FRAME to the front, so it occludes any frames it overlaps. |
e4ed805e | 1760 | If FRAME is invisible or iconified, make it visible. |
14ff1ee0 PJ |
1761 | If you don't specify a frame, the selected frame is used. |
1762 | If Emacs is displaying on an ordinary terminal or some other device which | |
1763 | doesn't support multiple overlapping frames, this function does nothing. */) | |
1764 | (frame) | |
dbc4e1c1 JB |
1765 | Lisp_Object frame; |
1766 | { | |
828ac693 | 1767 | if (NILP (frame)) |
8d2666fe | 1768 | frame = selected_frame; |
828ac693 | 1769 | |
b7826503 | 1770 | CHECK_LIVE_FRAME (frame); |
8a981af5 RS |
1771 | |
1772 | /* Do like the documentation says. */ | |
1773 | Fmake_frame_visible (frame); | |
1774 | ||
dbc4e1c1 JB |
1775 | if (frame_raise_lower_hook) |
1776 | (*frame_raise_lower_hook) (XFRAME (frame), 1); | |
1777 | ||
1778 | return Qnil; | |
1779 | } | |
1780 | ||
b49f5578 | 1781 | /* Should we have a corresponding function called Flower_Power? */ |
e518d5e1 | 1782 | DEFUN ("lower-frame", Flower_frame, Slower_frame, 0, 1, "", |
14ff1ee0 PJ |
1783 | doc: /* Send FRAME to the back, so it is occluded by any frames that overlap it. |
1784 | If you don't specify a frame, the selected frame is used. | |
1785 | If Emacs is displaying on an ordinary terminal or some other device which | |
1786 | doesn't support multiple overlapping frames, this function does nothing. */) | |
1787 | (frame) | |
dbc4e1c1 JB |
1788 | Lisp_Object frame; |
1789 | { | |
828ac693 | 1790 | if (NILP (frame)) |
8d2666fe | 1791 | frame = selected_frame; |
828ac693 | 1792 | |
b7826503 | 1793 | CHECK_LIVE_FRAME (frame); |
177c0ea7 | 1794 | |
dbc4e1c1 JB |
1795 | if (frame_raise_lower_hook) |
1796 | (*frame_raise_lower_hook) (XFRAME (frame), 0); | |
1797 | ||
1798 | return Qnil; | |
1799 | } | |
1800 | ||
d5e7c279 | 1801 | \f |
ff11dfa1 | 1802 | DEFUN ("redirect-frame-focus", Fredirect_frame_focus, Sredirect_frame_focus, |
d5e7c279 | 1803 | 1, 2, 0, |
14ff1ee0 PJ |
1804 | doc: /* Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME. |
1805 | In other words, switch-frame events caused by events in FRAME will | |
1806 | request a switch to FOCUS-FRAME, and `last-event-frame' will be | |
1807 | FOCUS-FRAME after reading an event typed at FRAME. | |
1808 | ||
1809 | If FOCUS-FRAME is omitted or nil, any existing redirection is | |
1810 | cancelled, and the frame again receives its own keystrokes. | |
1811 | ||
1812 | Focus redirection is useful for temporarily redirecting keystrokes to | |
1813 | a surrogate minibuffer frame when a frame doesn't have its own | |
1814 | minibuffer window. | |
1815 | ||
66a9dbbe | 1816 | A frame's focus redirection can be changed by `select-frame'. If frame |
14ff1ee0 PJ |
1817 | FOO is selected, and then a different frame BAR is selected, any |
1818 | frames redirecting their focus to FOO are shifted to redirect their | |
1819 | focus to BAR. This allows focus redirection to work properly when the | |
1820 | user switches from one frame to another using `select-window'. | |
1821 | ||
1822 | This means that a frame whose focus is redirected to itself is treated | |
1823 | differently from a frame whose focus is redirected to nil; the former | |
66a9dbbe | 1824 | is affected by `select-frame', while the latter is not. |
14ff1ee0 PJ |
1825 | |
1826 | The redirection lasts until `redirect-frame-focus' is called to change it. */) | |
1827 | (frame, focus_frame) | |
1828 | Lisp_Object frame, focus_frame; | |
d5e7c279 | 1829 | { |
13144095 JB |
1830 | /* Note that we don't check for a live frame here. It's reasonable |
1831 | to redirect the focus of a frame you're about to delete, if you | |
1832 | know what other frame should receive those keystrokes. */ | |
b7826503 | 1833 | CHECK_FRAME (frame); |
f9898cc6 | 1834 | |
a42e9724 | 1835 | if (! NILP (focus_frame)) |
b7826503 | 1836 | CHECK_LIVE_FRAME (focus_frame); |
d5e7c279 | 1837 | |
ff11dfa1 | 1838 | XFRAME (frame)->focus_frame = focus_frame; |
d5e7c279 | 1839 | |
ff11dfa1 | 1840 | if (frame_rehighlight_hook) |
dc0700f6 | 1841 | (*frame_rehighlight_hook) (XFRAME (frame)); |
177c0ea7 | 1842 | |
d5e7c279 JB |
1843 | return Qnil; |
1844 | } | |
1845 | ||
1846 | ||
ff11dfa1 | 1847 | DEFUN ("frame-focus", Fframe_focus, Sframe_focus, 1, 1, 0, |
14ff1ee0 PJ |
1848 | doc: /* Return the frame to which FRAME's keystrokes are currently being sent. |
1849 | This returns nil if FRAME's focus is not redirected. | |
1850 | See `redirect-frame-focus'. */) | |
1851 | (frame) | |
1852 | Lisp_Object frame; | |
d5e7c279 | 1853 | { |
b7826503 | 1854 | CHECK_LIVE_FRAME (frame); |
a42e9724 | 1855 | |
ff11dfa1 | 1856 | return FRAME_FOCUS_FRAME (XFRAME (frame)); |
d5e7c279 JB |
1857 | } |
1858 | ||
1859 | ||
dc6f92b8 | 1860 | \f |
329ca574 RS |
1861 | /* Return the value of frame parameter PROP in frame FRAME. */ |
1862 | ||
dc6f92b8 | 1863 | Lisp_Object |
ff11dfa1 JB |
1864 | get_frame_param (frame, prop) |
1865 | register struct frame *frame; | |
dc6f92b8 JB |
1866 | Lisp_Object prop; |
1867 | { | |
1868 | register Lisp_Object tem; | |
1869 | ||
ff11dfa1 | 1870 | tem = Fassq (prop, frame->param_alist); |
dc6f92b8 JB |
1871 | if (EQ (tem, Qnil)) |
1872 | return tem; | |
1873 | return Fcdr (tem); | |
1874 | } | |
1875 | ||
329ca574 RS |
1876 | /* Return the buffer-predicate of the selected frame. */ |
1877 | ||
1878 | Lisp_Object | |
98ce1622 RS |
1879 | frame_buffer_predicate (frame) |
1880 | Lisp_Object frame; | |
329ca574 | 1881 | { |
98ce1622 | 1882 | return XFRAME (frame)->buffer_predicate; |
329ca574 RS |
1883 | } |
1884 | ||
fa54c6ae RS |
1885 | /* Return the buffer-list of the selected frame. */ |
1886 | ||
1887 | Lisp_Object | |
98ce1622 RS |
1888 | frame_buffer_list (frame) |
1889 | Lisp_Object frame; | |
fa54c6ae | 1890 | { |
98ce1622 | 1891 | return XFRAME (frame)->buffer_list; |
fa54c6ae RS |
1892 | } |
1893 | ||
1894 | /* Set the buffer-list of the selected frame. */ | |
1895 | ||
1896 | void | |
98ce1622 RS |
1897 | set_frame_buffer_list (frame, list) |
1898 | Lisp_Object frame, list; | |
fa54c6ae | 1899 | { |
98ce1622 | 1900 | XFRAME (frame)->buffer_list = list; |
fa54c6ae RS |
1901 | } |
1902 | ||
1903 | /* Discard BUFFER from the buffer-list of each frame. */ | |
1904 | ||
1905 | void | |
1906 | frames_discard_buffer (buffer) | |
1907 | Lisp_Object buffer; | |
1908 | { | |
1909 | Lisp_Object frame, tail; | |
1910 | ||
1911 | FOR_EACH_FRAME (tail, frame) | |
1912 | { | |
1913 | XFRAME (frame)->buffer_list | |
1914 | = Fdelq (buffer, XFRAME (frame)->buffer_list); | |
1915 | } | |
1916 | } | |
1917 | ||
329ca574 RS |
1918 | /* Modify the alist in *ALISTPTR to associate PROP with VAL. |
1919 | If the alist already has an element for PROP, we change it. */ | |
1920 | ||
dc6f92b8 | 1921 | void |
fd0c2bd1 | 1922 | store_in_alist (alistptr, prop, val) |
dc6f92b8 | 1923 | Lisp_Object *alistptr, val; |
fd0c2bd1 | 1924 | Lisp_Object prop; |
dc6f92b8 JB |
1925 | { |
1926 | register Lisp_Object tem; | |
dc6f92b8 | 1927 | |
dc6f92b8 JB |
1928 | tem = Fassq (prop, *alistptr); |
1929 | if (EQ (tem, Qnil)) | |
1930 | *alistptr = Fcons (Fcons (prop, val), *alistptr); | |
1931 | else | |
1932 | Fsetcdr (tem, val); | |
1933 | } | |
1934 | ||
e5317d61 EZ |
1935 | static int |
1936 | frame_name_fnn_p (str, len) | |
1937 | char *str; | |
1938 | int len; | |
1939 | { | |
1940 | if (len > 1 && str[0] == 'F') | |
1941 | { | |
1942 | char *end_ptr; | |
e5317d61 | 1943 | |
48970f2f EZ |
1944 | strtol (str + 1, &end_ptr, 10); |
1945 | ||
e5317d61 EZ |
1946 | if (end_ptr == str + len) |
1947 | return 1; | |
1948 | } | |
1949 | return 0; | |
1950 | } | |
1951 | ||
1952 | /* Set the name of the terminal frame. Also used by MSDOS frames. | |
1953 | Modeled after x_set_name which is used for WINDOW frames. */ | |
1954 | ||
66a9dbbe | 1955 | static void |
e5317d61 EZ |
1956 | set_term_frame_name (f, name) |
1957 | struct frame *f; | |
1958 | Lisp_Object name; | |
1959 | { | |
1960 | f->explicit_name = ! NILP (name); | |
1961 | ||
1962 | /* If NAME is nil, set the name to F<num>. */ | |
1963 | if (NILP (name)) | |
1964 | { | |
1965 | char namebuf[20]; | |
1966 | ||
1967 | /* Check for no change needed in this very common case | |
1968 | before we do any consing. */ | |
d5db4077 KR |
1969 | if (frame_name_fnn_p (SDATA (f->name), |
1970 | SBYTES (f->name))) | |
e5317d61 EZ |
1971 | return; |
1972 | ||
1973 | terminal_frame_count++; | |
1974 | sprintf (namebuf, "F%d", terminal_frame_count); | |
1975 | name = build_string (namebuf); | |
1976 | } | |
1977 | else | |
1978 | { | |
b7826503 | 1979 | CHECK_STRING (name); |
e5317d61 EZ |
1980 | |
1981 | /* Don't change the name if it's already NAME. */ | |
1982 | if (! NILP (Fstring_equal (name, f->name))) | |
1983 | return; | |
1984 | ||
1985 | /* Don't allow the user to set the frame name to F<num>, so it | |
1986 | doesn't clash with the names we generate for terminal frames. */ | |
d5db4077 | 1987 | if (frame_name_fnn_p (SDATA (name), SBYTES (name))) |
e5317d61 EZ |
1988 | error ("Frame names of the form F<num> are usurped by Emacs"); |
1989 | } | |
1990 | ||
1991 | f->name = name; | |
1992 | update_mode_lines = 1; | |
1993 | } | |
1994 | ||
dc6f92b8 | 1995 | void |
ff11dfa1 JB |
1996 | store_frame_param (f, prop, val) |
1997 | struct frame *f; | |
dc6f92b8 JB |
1998 | Lisp_Object prop, val; |
1999 | { | |
7eb63b72 | 2000 | register Lisp_Object old_alist_elt; |
dc6f92b8 | 2001 | |
7eb63b72 GM |
2002 | /* The buffer-alist parameter is stored in a special place and is |
2003 | not in the alist. */ | |
fa54c6ae RS |
2004 | if (EQ (prop, Qbuffer_list)) |
2005 | { | |
2006 | f->buffer_list = val; | |
2007 | return; | |
2008 | } | |
2009 | ||
7eb63b72 GM |
2010 | /* If PROP is a symbol which is supposed to have frame-local values, |
2011 | and it is set up based on this frame, switch to the global | |
2012 | binding. That way, we can create or alter the frame-local binding | |
2013 | without messing up the symbol's status. */ | |
2014 | if (SYMBOLP (prop)) | |
2015 | { | |
2016 | Lisp_Object valcontents; | |
f5c1dd0d | 2017 | valcontents = SYMBOL_VALUE (prop); |
7eb63b72 GM |
2018 | if ((BUFFER_LOCAL_VALUEP (valcontents) |
2019 | || SOME_BUFFER_LOCAL_VALUEP (valcontents)) | |
2020 | && XBUFFER_LOCAL_VALUE (valcontents)->check_frame | |
2021 | && XFRAME (XBUFFER_LOCAL_VALUE (valcontents)->frame) == f) | |
2022 | swap_in_global_binding (prop); | |
2023 | } | |
2024 | ||
94674d18 EZ |
2025 | #ifndef WINDOWSNT |
2026 | /* The tty color mode needs to be set before the frame's parameter | |
2027 | alist is updated with the new value, because set_tty_color_mode | |
2028 | wants to look at the old mode. */ | |
2029 | if (FRAME_TERMCAP_P (f) && EQ (prop, Qtty_color_mode)) | |
2030 | set_tty_color_mode (f, val); | |
2031 | #endif | |
2032 | ||
7eb63b72 GM |
2033 | /* Update the frame parameter alist. */ |
2034 | old_alist_elt = Fassq (prop, f->param_alist); | |
2035 | if (EQ (old_alist_elt, Qnil)) | |
ff11dfa1 | 2036 | f->param_alist = Fcons (Fcons (prop, val), f->param_alist); |
dc6f92b8 | 2037 | else |
7eb63b72 | 2038 | Fsetcdr (old_alist_elt, val); |
bc93c097 | 2039 | |
7eb63b72 GM |
2040 | /* Update some other special parameters in their special places |
2041 | in addition to the alist. */ | |
177c0ea7 | 2042 | |
329ca574 RS |
2043 | if (EQ (prop, Qbuffer_predicate)) |
2044 | f->buffer_predicate = val; | |
2045 | ||
032d78fe | 2046 | if (! FRAME_WINDOW_P (f)) |
e5317d61 EZ |
2047 | { |
2048 | if (EQ (prop, Qmenu_bar_lines)) | |
2049 | set_menu_bar_lines (f, val, make_number (FRAME_MENU_BAR_LINES (f))); | |
2050 | else if (EQ (prop, Qname)) | |
2051 | set_term_frame_name (f, val); | |
2052 | } | |
a249de79 | 2053 | |
e35d291d | 2054 | if (EQ (prop, Qminibuffer) && WINDOWP (val)) |
bc93c097 JB |
2055 | { |
2056 | if (! MINI_WINDOW_P (XWINDOW (val))) | |
7c402969 | 2057 | error ("Surrogate minibuffer windows must be minibuffer windows"); |
bc93c097 | 2058 | |
213bac8a | 2059 | if ((FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f)) |
7af7ef38 KH |
2060 | && !EQ (val, f->minibuffer_window)) |
2061 | error ("Can't change the surrogate minibuffer of a frame with its own minibuffer"); | |
bc93c097 JB |
2062 | |
2063 | /* Install the chosen minibuffer window, with proper buffer. */ | |
ff11dfa1 | 2064 | f->minibuffer_window = val; |
bc93c097 | 2065 | } |
dc6f92b8 JB |
2066 | } |
2067 | ||
ff11dfa1 | 2068 | DEFUN ("frame-parameters", Fframe_parameters, Sframe_parameters, 0, 1, 0, |
14ff1ee0 PJ |
2069 | doc: /* Return the parameters-alist of frame FRAME. |
2070 | It is a list of elements of the form (PARM . VALUE), where PARM is a symbol. | |
2071 | The meaningful PARMs depend on the kind of frame. | |
2072 | If FRAME is omitted, return information on the currently selected frame. */) | |
2073 | (frame) | |
ff11dfa1 | 2074 | Lisp_Object frame; |
dc6f92b8 JB |
2075 | { |
2076 | Lisp_Object alist; | |
f769f1b2 | 2077 | FRAME_PTR f; |
dd10ec4f | 2078 | int height, width; |
57629833 | 2079 | struct gcpro gcpro1; |
dc6f92b8 | 2080 | |
03390a72 | 2081 | if (NILP (frame)) |
8d2666fe GM |
2082 | frame = selected_frame; |
2083 | ||
b7826503 | 2084 | CHECK_FRAME (frame); |
8d2666fe | 2085 | f = XFRAME (frame); |
dc6f92b8 | 2086 | |
f769f1b2 | 2087 | if (!FRAME_LIVE_P (f)) |
dc6f92b8 JB |
2088 | return Qnil; |
2089 | ||
ff11dfa1 | 2090 | alist = Fcopy_alist (f->param_alist); |
57629833 | 2091 | GCPRO1 (alist); |
177c0ea7 | 2092 | |
2d764c78 | 2093 | if (!FRAME_WINDOW_P (f)) |
bb221971 | 2094 | { |
4aec4b29 EZ |
2095 | int fg = FRAME_FOREGROUND_PIXEL (f); |
2096 | int bg = FRAME_BACKGROUND_PIXEL (f); | |
e1d0bbc9 EZ |
2097 | Lisp_Object elt; |
2098 | ||
2099 | /* If the frame's parameter alist says the colors are | |
2100 | unspecified and reversed, take the frame's background pixel | |
2101 | for foreground and vice versa. */ | |
2102 | elt = Fassq (Qforeground_color, alist); | |
70de9f06 EZ |
2103 | if (!NILP (elt) && CONSP (elt) && STRINGP (XCDR (elt))) |
2104 | { | |
d5db4077 | 2105 | if (strncmp (SDATA (XCDR (elt)), |
70de9f06 | 2106 | unspecified_bg, |
d5db4077 | 2107 | SCHARS (XCDR (elt))) == 0) |
70de9f06 | 2108 | store_in_alist (&alist, Qforeground_color, tty_color_name (f, bg)); |
d5db4077 | 2109 | else if (strncmp (SDATA (XCDR (elt)), |
70de9f06 | 2110 | unspecified_fg, |
d5db4077 | 2111 | SCHARS (XCDR (elt))) == 0) |
70de9f06 EZ |
2112 | store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg)); |
2113 | } | |
e1d0bbc9 EZ |
2114 | else |
2115 | store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg)); | |
2116 | elt = Fassq (Qbackground_color, alist); | |
70de9f06 EZ |
2117 | if (!NILP (elt) && CONSP (elt) && STRINGP (XCDR (elt))) |
2118 | { | |
d5db4077 | 2119 | if (strncmp (SDATA (XCDR (elt)), |
70de9f06 | 2120 | unspecified_fg, |
d5db4077 | 2121 | SCHARS (XCDR (elt))) == 0) |
70de9f06 | 2122 | store_in_alist (&alist, Qbackground_color, tty_color_name (f, fg)); |
d5db4077 | 2123 | else if (strncmp (SDATA (XCDR (elt)), |
70de9f06 | 2124 | unspecified_bg, |
d5db4077 | 2125 | SCHARS (XCDR (elt))) == 0) |
70de9f06 EZ |
2126 | store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg)); |
2127 | } | |
e1d0bbc9 EZ |
2128 | else |
2129 | store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg)); | |
2d764c78 EZ |
2130 | store_in_alist (&alist, intern ("font"), |
2131 | build_string (FRAME_MSDOS_P (f) | |
2132 | ? "ms-dos" | |
4ec0d3c1 | 2133 | : FRAME_W32_P (f) ? "w32term" |
4ec0d3c1 | 2134 | :"tty")); |
bb221971 | 2135 | } |
fd0c2bd1 | 2136 | store_in_alist (&alist, Qname, f->name); |
5af5757b | 2137 | height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f)); |
dd10ec4f | 2138 | store_in_alist (&alist, Qheight, make_number (height)); |
5af5757b | 2139 | width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f)); |
dd10ec4f | 2140 | store_in_alist (&alist, Qwidth, make_number (width)); |
f769f1b2 | 2141 | store_in_alist (&alist, Qmodeline, (FRAME_WANTS_MODELINE_P (f) ? Qt : Qnil)); |
fd0c2bd1 | 2142 | store_in_alist (&alist, Qminibuffer, |
39acc701 | 2143 | (! FRAME_HAS_MINIBUF_P (f) ? Qnil |
f769f1b2 KH |
2144 | : FRAME_MINIBUF_ONLY_P (f) ? Qonly |
2145 | : FRAME_MINIBUF_WINDOW (f))); | |
2146 | store_in_alist (&alist, Qunsplittable, (FRAME_NO_SPLIT_P (f) ? Qt : Qnil)); | |
03390a72 | 2147 | store_in_alist (&alist, Qbuffer_list, frame_buffer_list (frame)); |
fd0c2bd1 | 2148 | |
dbc4e1c1 | 2149 | /* I think this should be done with a hook. */ |
032d78fe GV |
2150 | #ifdef HAVE_WINDOW_SYSTEM |
2151 | if (FRAME_WINDOW_P (f)) | |
ff11dfa1 | 2152 | x_report_frame_params (f, &alist); |
b6dd20ed | 2153 | else |
fd0c2bd1 | 2154 | #endif |
16a3738c KH |
2155 | { |
2156 | /* This ought to be correct in f->param_alist for an X frame. */ | |
2157 | Lisp_Object lines; | |
f4e93c40 | 2158 | XSETFASTINT (lines, FRAME_MENU_BAR_LINES (f)); |
16a3738c KH |
2159 | store_in_alist (&alist, Qmenu_bar_lines, lines); |
2160 | } | |
57629833 GM |
2161 | |
2162 | UNGCPRO; | |
dc6f92b8 JB |
2163 | return alist; |
2164 | } | |
2165 | ||
8b60f7bc GM |
2166 | |
2167 | DEFUN ("frame-parameter", Fframe_parameter, Sframe_parameter, 2, 2, 0, | |
14ff1ee0 PJ |
2168 | doc: /* Return FRAME's value for parameter PARAMETER. |
2169 | If FRAME is nil, describe the currently selected frame. */) | |
2170 | (frame, parameter) | |
2171 | Lisp_Object frame, parameter; | |
8b60f7bc GM |
2172 | { |
2173 | struct frame *f; | |
2174 | Lisp_Object value; | |
2175 | ||
2176 | if (NILP (frame)) | |
2177 | frame = selected_frame; | |
2178 | else | |
b7826503 PJ |
2179 | CHECK_FRAME (frame); |
2180 | CHECK_SYMBOL (parameter); | |
177c0ea7 | 2181 | |
8b60f7bc GM |
2182 | f = XFRAME (frame); |
2183 | value = Qnil; | |
177c0ea7 | 2184 | |
8b60f7bc GM |
2185 | if (FRAME_LIVE_P (f)) |
2186 | { | |
5cd62b8c | 2187 | /* Avoid consing in frequent cases. */ |
67d853e6 GM |
2188 | if (EQ (parameter, Qname)) |
2189 | value = f->name; | |
6345f6aa GM |
2190 | #ifdef HAVE_X_WINDOWS |
2191 | else if (EQ (parameter, Qdisplay) && FRAME_X_P (f)) | |
2192 | value = XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element); | |
2193 | #endif /* HAVE_X_WINDOWS */ | |
75700ff2 GM |
2194 | else if (EQ (parameter, Qbackground_color) |
2195 | || EQ (parameter, Qforeground_color)) | |
67d853e6 GM |
2196 | { |
2197 | value = Fassq (parameter, f->param_alist); | |
2198 | if (CONSP (value)) | |
5f65b39d | 2199 | { |
5f65b39d EZ |
2200 | value = XCDR (value); |
2201 | /* Fframe_parameters puts the actual fg/bg color names, | |
2202 | even if f->param_alist says otherwise. This is | |
2203 | important when param_alist's notion of colors is | |
2204 | "unspecified". We need to do the same here. */ | |
2205 | if (STRINGP (value) && !FRAME_WINDOW_P (f)) | |
2206 | { | |
c9b08ba8 | 2207 | const char *color_name; |
e1d0bbc9 EZ |
2208 | EMACS_INT csz; |
2209 | ||
2210 | if (EQ (parameter, Qbackground_color)) | |
2211 | { | |
d5db4077 KR |
2212 | color_name = SDATA (value); |
2213 | csz = SCHARS (value); | |
e1d0bbc9 EZ |
2214 | if (strncmp (color_name, unspecified_bg, csz) == 0) |
2215 | value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f)); | |
2216 | else if (strncmp (color_name, unspecified_fg, csz) == 0) | |
2217 | value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f)); | |
2218 | } | |
2219 | else if (EQ (parameter, Qforeground_color)) | |
2220 | { | |
d5db4077 KR |
2221 | color_name = SDATA (value); |
2222 | csz = SCHARS (value); | |
e1d0bbc9 EZ |
2223 | if (strncmp (color_name, unspecified_fg, csz) == 0) |
2224 | value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f)); | |
2225 | else if (strncmp (color_name, unspecified_bg, csz) == 0) | |
2226 | value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f)); | |
2227 | } | |
5f65b39d EZ |
2228 | } |
2229 | } | |
b23236fb EZ |
2230 | else |
2231 | value = Fcdr (Fassq (parameter, Fframe_parameters (frame))); | |
67d853e6 | 2232 | } |
75700ff2 GM |
2233 | else if (EQ (parameter, Qdisplay_type) |
2234 | || EQ (parameter, Qbackground_mode)) | |
75700ff2 GM |
2235 | value = Fcdr (Fassq (parameter, f->param_alist)); |
2236 | else | |
2237 | value = Fcdr (Fassq (parameter, Fframe_parameters (frame))); | |
8b60f7bc | 2238 | } |
177c0ea7 | 2239 | |
8b60f7bc GM |
2240 | return value; |
2241 | } | |
2242 | ||
2243 | ||
177c0ea7 | 2244 | DEFUN ("modify-frame-parameters", Fmodify_frame_parameters, |
ff11dfa1 | 2245 | Smodify_frame_parameters, 2, 2, 0, |
14ff1ee0 PJ |
2246 | doc: /* Modify the parameters of frame FRAME according to ALIST. |
2247 | If FRAME is nil, it defaults to the selected frame. | |
2248 | ALIST is an alist of parameters to change and their new values. | |
2249 | Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol. | |
2250 | The meaningful PARMs depend on the kind of frame. | |
2251 | Undefined PARMs are ignored, but stored in the frame's parameter list | |
2252 | so that `frame-parameters' will return them. | |
2253 | ||
2254 | The value of frame parameter FOO can also be accessed | |
2255 | as a frame-local binding for the variable FOO, if you have | |
2256 | enabled such bindings for that variable with `make-variable-frame-local'. */) | |
2257 | (frame, alist) | |
ff11dfa1 | 2258 | Lisp_Object frame, alist; |
dc6f92b8 | 2259 | { |
fd0c2bd1 | 2260 | FRAME_PTR f; |
213bac8a | 2261 | register Lisp_Object tail, prop, val; |
331379bf | 2262 | int count = SPECPDL_INDEX (); |
3df1fda2 GM |
2263 | |
2264 | /* Bind this to t to inhibit initialization of the default face from | |
2265 | X resources in face-set-after-frame-default. If we don't inhibit | |
2266 | this, modifying the `font' frame parameter, for example, while | |
2267 | there is a `default.attributeFont' X resource, won't work, | |
2268 | because `default's font is reset to the value of the X resource | |
2269 | and that resets the `font' frame parameter. */ | |
2270 | specbind (Qinhibit_default_face_x_resources, Qt); | |
dc6f92b8 | 2271 | |
ff11dfa1 | 2272 | if (EQ (frame, Qnil)) |
8d2666fe | 2273 | frame = selected_frame; |
b7826503 | 2274 | CHECK_LIVE_FRAME (frame); |
8d2666fe | 2275 | f = XFRAME (frame); |
dc6f92b8 | 2276 | |
dbc4e1c1 | 2277 | /* I think this should be done with a hook. */ |
032d78fe GV |
2278 | #ifdef HAVE_WINDOW_SYSTEM |
2279 | if (FRAME_WINDOW_P (f)) | |
fd0c2bd1 | 2280 | x_set_frame_parameters (f, alist); |
329ca574 | 2281 | else |
bb221971 RS |
2282 | #endif |
2283 | #ifdef MSDOS | |
2284 | if (FRAME_MSDOS_P (f)) | |
2285 | IT_set_frame_parameters (f, alist); | |
2286 | else | |
329ca574 | 2287 | #endif |
574a1a90 | 2288 | |
41d44f1f RS |
2289 | { |
2290 | int length = XINT (Flength (alist)); | |
2291 | int i; | |
2292 | Lisp_Object *parms | |
2293 | = (Lisp_Object *) alloca (length * sizeof (Lisp_Object)); | |
2294 | Lisp_Object *values | |
2295 | = (Lisp_Object *) alloca (length * sizeof (Lisp_Object)); | |
2296 | ||
2297 | /* Extract parm names and values into those vectors. */ | |
2298 | ||
2299 | i = 0; | |
2300 | for (tail = alist; CONSP (tail); tail = Fcdr (tail)) | |
2301 | { | |
213bac8a | 2302 | Lisp_Object elt; |
41d44f1f RS |
2303 | |
2304 | elt = Fcar (tail); | |
2305 | parms[i] = Fcar (elt); | |
2306 | values[i] = Fcdr (elt); | |
2307 | i++; | |
2308 | } | |
2309 | ||
2310 | /* Now process them in reverse of specified order. */ | |
2311 | for (i--; i >= 0; i--) | |
2312 | { | |
2313 | prop = parms[i]; | |
2314 | val = values[i]; | |
2315 | store_frame_param (f, prop, val); | |
33d537f0 JL |
2316 | |
2317 | /* Changing the background color might change the background | |
2318 | mode, so that we have to load new defface specs. | |
2319 | Call frame-set-background-mode to do that. */ | |
2320 | if (EQ (prop, Qbackground_color)) | |
2321 | call1 (Qframe_set_background_mode, frame); | |
41d44f1f RS |
2322 | } |
2323 | } | |
dc6f92b8 | 2324 | |
3df1fda2 | 2325 | return unbind_to (count, Qnil); |
dc6f92b8 JB |
2326 | } |
2327 | \f | |
a26a1f95 | 2328 | DEFUN ("frame-char-height", Fframe_char_height, Sframe_char_height, |
14ff1ee0 PJ |
2329 | 0, 1, 0, |
2330 | doc: /* Height in pixels of a line in the font in frame FRAME. | |
2331 | If FRAME is omitted, the selected frame is used. | |
2332 | For a terminal frame, the value is always 1. */) | |
ff11dfa1 JB |
2333 | (frame) |
2334 | Lisp_Object frame; | |
dc6f92b8 | 2335 | { |
a26a1f95 | 2336 | struct frame *f; |
dc6f92b8 | 2337 | |
a26a1f95 | 2338 | if (NILP (frame)) |
8d2666fe | 2339 | frame = selected_frame; |
b7826503 | 2340 | CHECK_FRAME (frame); |
8d2666fe | 2341 | f = XFRAME (frame); |
a26a1f95 | 2342 | |
032d78fe GV |
2343 | #ifdef HAVE_WINDOW_SYSTEM |
2344 | if (FRAME_WINDOW_P (f)) | |
a26a1f95 RS |
2345 | return make_number (x_char_height (f)); |
2346 | else | |
dc6d9681 | 2347 | #endif |
a26a1f95 RS |
2348 | return make_number (1); |
2349 | } | |
dc6d9681 | 2350 | |
dc6f92b8 | 2351 | |
a26a1f95 | 2352 | DEFUN ("frame-char-width", Fframe_char_width, Sframe_char_width, |
14ff1ee0 PJ |
2353 | 0, 1, 0, |
2354 | doc: /* Width in pixels of characters in the font in frame FRAME. | |
2355 | If FRAME is omitted, the selected frame is used. | |
31b7cc74 | 2356 | On a graphical screen, the width is the standard width of the default font. |
14ff1ee0 PJ |
2357 | For a terminal screen, the value is always 1. */) |
2358 | (frame) | |
a26a1f95 | 2359 | Lisp_Object frame; |
dc6f92b8 | 2360 | { |
a26a1f95 RS |
2361 | struct frame *f; |
2362 | ||
2363 | if (NILP (frame)) | |
8d2666fe | 2364 | frame = selected_frame; |
b7826503 | 2365 | CHECK_FRAME (frame); |
8d2666fe | 2366 | f = XFRAME (frame); |
a26a1f95 | 2367 | |
032d78fe GV |
2368 | #ifdef HAVE_WINDOW_SYSTEM |
2369 | if (FRAME_WINDOW_P (f)) | |
a26a1f95 RS |
2370 | return make_number (x_char_width (f)); |
2371 | else | |
2372 | #endif | |
2373 | return make_number (1); | |
dc6f92b8 JB |
2374 | } |
2375 | ||
177c0ea7 | 2376 | DEFUN ("frame-pixel-height", Fframe_pixel_height, |
a26a1f95 | 2377 | Sframe_pixel_height, 0, 1, 0, |
14ff1ee0 PJ |
2378 | doc: /* Return a FRAME's height in pixels. |
2379 | This counts only the height available for text lines, | |
2380 | not menu bars on window-system Emacs frames. | |
2381 | For a terminal frame, the result really gives the height in characters. | |
2382 | If FRAME is omitted, the selected frame is used. */) | |
2383 | (frame) | |
a26a1f95 | 2384 | Lisp_Object frame; |
dc6f92b8 | 2385 | { |
a26a1f95 RS |
2386 | struct frame *f; |
2387 | ||
2388 | if (NILP (frame)) | |
8d2666fe | 2389 | frame = selected_frame; |
b7826503 | 2390 | CHECK_FRAME (frame); |
8d2666fe | 2391 | f = XFRAME (frame); |
a26a1f95 | 2392 | |
032d78fe GV |
2393 | #ifdef HAVE_WINDOW_SYSTEM |
2394 | if (FRAME_WINDOW_P (f)) | |
a26a1f95 RS |
2395 | return make_number (x_pixel_height (f)); |
2396 | else | |
dc6d9681 | 2397 | #endif |
5af5757b | 2398 | return make_number (FRAME_LINES (f)); |
a26a1f95 RS |
2399 | } |
2400 | ||
177c0ea7 | 2401 | DEFUN ("frame-pixel-width", Fframe_pixel_width, |
a26a1f95 | 2402 | Sframe_pixel_width, 0, 1, 0, |
14ff1ee0 PJ |
2403 | doc: /* Return FRAME's width in pixels. |
2404 | For a terminal frame, the result really gives the width in characters. | |
2405 | If FRAME is omitted, the selected frame is used. */) | |
2406 | (frame) | |
a26a1f95 RS |
2407 | Lisp_Object frame; |
2408 | { | |
2409 | struct frame *f; | |
2410 | ||
2411 | if (NILP (frame)) | |
8d2666fe | 2412 | frame = selected_frame; |
b7826503 | 2413 | CHECK_FRAME (frame); |
8d2666fe | 2414 | f = XFRAME (frame); |
dc6f92b8 | 2415 | |
032d78fe GV |
2416 | #ifdef HAVE_WINDOW_SYSTEM |
2417 | if (FRAME_WINDOW_P (f)) | |
a26a1f95 RS |
2418 | return make_number (x_pixel_width (f)); |
2419 | else | |
2420 | #endif | |
5af5757b | 2421 | return make_number (FRAME_COLS (f)); |
a26a1f95 RS |
2422 | } |
2423 | \f | |
ff11dfa1 | 2424 | DEFUN ("set-frame-height", Fset_frame_height, Sset_frame_height, 2, 3, 0, |
14ff1ee0 PJ |
2425 | doc: /* Specify that the frame FRAME has LINES lines. |
2426 | Optional third arg non-nil means that redisplay should use LINES lines | |
2427 | but that the idea of the actual height of the frame should not be changed. */) | |
2428 | (frame, lines, pretend) | |
735eeca3 | 2429 | Lisp_Object frame, lines, pretend; |
dc6f92b8 | 2430 | { |
ff11dfa1 | 2431 | register struct frame *f; |
dc6f92b8 | 2432 | |
b7826503 | 2433 | CHECK_NUMBER (lines); |
ff11dfa1 | 2434 | if (NILP (frame)) |
8d2666fe | 2435 | frame = selected_frame; |
b7826503 | 2436 | CHECK_LIVE_FRAME (frame); |
8d2666fe | 2437 | f = XFRAME (frame); |
dc6f92b8 | 2438 | |
dbc4e1c1 | 2439 | /* I think this should be done with a hook. */ |
032d78fe GV |
2440 | #ifdef HAVE_WINDOW_SYSTEM |
2441 | if (FRAME_WINDOW_P (f)) | |
dc6f92b8 | 2442 | { |
5af5757b KS |
2443 | if (XINT (lines) != FRAME_LINES (f)) |
2444 | x_set_window_size (f, 1, FRAME_COLS (f), XINT (lines)); | |
32347cf4 | 2445 | do_pending_window_change (0); |
dc6f92b8 JB |
2446 | } |
2447 | else | |
fd0c2bd1 | 2448 | #endif |
32347cf4 | 2449 | change_frame_size (f, XINT (lines), 0, !NILP (pretend), 0, 0); |
dc6f92b8 JB |
2450 | return Qnil; |
2451 | } | |
2452 | ||
ff11dfa1 | 2453 | DEFUN ("set-frame-width", Fset_frame_width, Sset_frame_width, 2, 3, 0, |
14ff1ee0 PJ |
2454 | doc: /* Specify that the frame FRAME has COLS columns. |
2455 | Optional third arg non-nil means that redisplay should use COLS columns | |
2456 | but that the idea of the actual width of the frame should not be changed. */) | |
2457 | (frame, cols, pretend) | |
fd0c2bd1 | 2458 | Lisp_Object frame, cols, pretend; |
dc6f92b8 | 2459 | { |
ff11dfa1 | 2460 | register struct frame *f; |
b7826503 | 2461 | CHECK_NUMBER (cols); |
ff11dfa1 | 2462 | if (NILP (frame)) |
8d2666fe | 2463 | frame = selected_frame; |
b7826503 | 2464 | CHECK_LIVE_FRAME (frame); |
8d2666fe | 2465 | f = XFRAME (frame); |
dc6f92b8 | 2466 | |
dbc4e1c1 | 2467 | /* I think this should be done with a hook. */ |
032d78fe GV |
2468 | #ifdef HAVE_WINDOW_SYSTEM |
2469 | if (FRAME_WINDOW_P (f)) | |
dc6f92b8 | 2470 | { |
5af5757b KS |
2471 | if (XINT (cols) != FRAME_COLS (f)) |
2472 | x_set_window_size (f, 1, XINT (cols), FRAME_LINES (f)); | |
32347cf4 | 2473 | do_pending_window_change (0); |
dc6f92b8 JB |
2474 | } |
2475 | else | |
fd0c2bd1 | 2476 | #endif |
32347cf4 | 2477 | change_frame_size (f, 0, XINT (cols), !NILP (pretend), 0, 0); |
dc6f92b8 JB |
2478 | return Qnil; |
2479 | } | |
2480 | ||
ff11dfa1 | 2481 | DEFUN ("set-frame-size", Fset_frame_size, Sset_frame_size, 3, 3, 0, |
14ff1ee0 PJ |
2482 | doc: /* Sets size of FRAME to COLS by ROWS, measured in characters. */) |
2483 | (frame, cols, rows) | |
ff11dfa1 | 2484 | Lisp_Object frame, cols, rows; |
dc6f92b8 | 2485 | { |
ff11dfa1 | 2486 | register struct frame *f; |
dc6f92b8 | 2487 | |
b7826503 PJ |
2488 | CHECK_LIVE_FRAME (frame); |
2489 | CHECK_NUMBER (cols); | |
2490 | CHECK_NUMBER (rows); | |
ff11dfa1 | 2491 | f = XFRAME (frame); |
dc6f92b8 | 2492 | |
dbc4e1c1 | 2493 | /* I think this should be done with a hook. */ |
032d78fe GV |
2494 | #ifdef HAVE_WINDOW_SYSTEM |
2495 | if (FRAME_WINDOW_P (f)) | |
dc6f92b8 | 2496 | { |
5af5757b KS |
2497 | if (XINT (rows) != FRAME_LINES (f) |
2498 | || XINT (cols) != FRAME_COLS (f) | |
2499 | || f->new_text_lines || f->new_text_cols) | |
808c0f20 | 2500 | x_set_window_size (f, 1, XINT (cols), XINT (rows)); |
32347cf4 | 2501 | do_pending_window_change (0); |
dc6f92b8 JB |
2502 | } |
2503 | else | |
fd0c2bd1 | 2504 | #endif |
32347cf4 | 2505 | change_frame_size (f, XINT (rows), XINT (cols), 0, 0, 0); |
dc6f92b8 JB |
2506 | |
2507 | return Qnil; | |
2508 | } | |
2509 | ||
177c0ea7 | 2510 | DEFUN ("set-frame-position", Fset_frame_position, |
ff11dfa1 | 2511 | Sset_frame_position, 3, 3, 0, |
14ff1ee0 PJ |
2512 | doc: /* Sets position of FRAME in pixels to XOFFSET by YOFFSET. |
2513 | This is actually the position of the upper left corner of the frame. | |
2514 | Negative values for XOFFSET or YOFFSET are interpreted relative to | |
2515 | the rightmost or bottommost possible position (that stays within the screen). */) | |
2516 | (frame, xoffset, yoffset) | |
ff11dfa1 | 2517 | Lisp_Object frame, xoffset, yoffset; |
dc6f92b8 | 2518 | { |
ff11dfa1 | 2519 | register struct frame *f; |
dc6f92b8 | 2520 | |
b7826503 PJ |
2521 | CHECK_LIVE_FRAME (frame); |
2522 | CHECK_NUMBER (xoffset); | |
2523 | CHECK_NUMBER (yoffset); | |
ff11dfa1 | 2524 | f = XFRAME (frame); |
dc6f92b8 | 2525 | |
dbc4e1c1 | 2526 | /* I think this should be done with a hook. */ |
032d78fe GV |
2527 | #ifdef HAVE_WINDOW_SYSTEM |
2528 | if (FRAME_WINDOW_P (f)) | |
c7c70761 | 2529 | x_set_offset (f, XINT (xoffset), XINT (yoffset), 1); |
fd0c2bd1 | 2530 | #endif |
dc6f92b8 JB |
2531 | |
2532 | return Qt; | |
2533 | } | |
dc6d9681 | 2534 | |
dc6f92b8 | 2535 | \f |
972f4259 KS |
2536 | /*********************************************************************** |
2537 | Frame Parameters | |
2538 | ***********************************************************************/ | |
2539 | ||
2540 | /* Connect the frame-parameter names for X frames | |
2541 | to the ways of passing the parameter values to the window system. | |
2542 | ||
2543 | The name of a parameter, as a Lisp symbol, | |
2544 | has an `x-frame-parameter' property which is an integer in Lisp | |
2545 | that is an index in this table. */ | |
2546 | ||
2547 | struct frame_parm_table { | |
2548 | char *name; | |
2549 | Lisp_Object *variable; | |
2550 | }; | |
2551 | ||
2552 | static struct frame_parm_table frame_parms[] = | |
2553 | { | |
2554 | {"auto-raise", &Qauto_raise}, | |
2555 | {"auto-lower", &Qauto_lower}, | |
2556 | {"background-color", 0}, | |
2557 | {"border-color", &Qborder_color}, | |
2558 | {"border-width", &Qborder_width}, | |
2559 | {"cursor-color", &Qcursor_color}, | |
2560 | {"cursor-type", &Qcursor_type}, | |
2561 | {"font", 0}, | |
2562 | {"foreground-color", 0}, | |
2563 | {"icon-name", &Qicon_name}, | |
2564 | {"icon-type", &Qicon_type}, | |
2565 | {"internal-border-width", &Qinternal_border_width}, | |
2566 | {"menu-bar-lines", &Qmenu_bar_lines}, | |
2567 | {"mouse-color", &Qmouse_color}, | |
2568 | {"name", &Qname}, | |
2569 | {"scroll-bar-width", &Qscroll_bar_width}, | |
2570 | {"title", &Qtitle}, | |
2571 | {"unsplittable", &Qunsplittable}, | |
2572 | {"vertical-scroll-bars", &Qvertical_scroll_bars}, | |
2573 | {"visibility", &Qvisibility}, | |
2574 | {"tool-bar-lines", &Qtool_bar_lines}, | |
2575 | {"scroll-bar-foreground", &Qscroll_bar_foreground}, | |
2576 | {"scroll-bar-background", &Qscroll_bar_background}, | |
2577 | {"screen-gamma", &Qscreen_gamma}, | |
2578 | {"line-spacing", &Qline_spacing}, | |
2579 | {"left-fringe", &Qleft_fringe}, | |
2580 | {"right-fringe", &Qright_fringe}, | |
2581 | {"wait-for-wm", &Qwait_for_wm}, | |
2582 | {"fullscreen", &Qfullscreen}, | |
2583 | }; | |
2584 | ||
2585 | #ifdef HAVE_WINDOW_SYSTEM | |
2586 | ||
2587 | extern Lisp_Object Qbox; | |
2588 | extern Lisp_Object Qtop; | |
2589 | ||
2590 | /* Calculate fullscreen size. Return in *TOP_POS and *LEFT_POS the | |
2591 | wanted positions of the WM window (not emacs window). | |
2592 | Return in *WIDTH and *HEIGHT the wanted width and height of Emacs | |
2593 | window (FRAME_X_WINDOW). | |
2594 | */ | |
2595 | ||
dfcf069d | 2596 | void |
972f4259 KS |
2597 | x_fullscreen_adjust (f, width, height, top_pos, left_pos) |
2598 | struct frame *f; | |
2599 | int *width; | |
2600 | int *height; | |
2601 | int *top_pos; | |
2602 | int *left_pos; | |
dc6f92b8 | 2603 | { |
5af5757b KS |
2604 | int newwidth = FRAME_COLS (f); |
2605 | int newheight = FRAME_LINES (f); | |
dc6f92b8 | 2606 | |
5af5757b KS |
2607 | *top_pos = f->top_pos; |
2608 | *left_pos = f->left_pos; | |
3df1fda2 | 2609 | |
5af5757b | 2610 | if (f->want_fullscreen & FULLSCREEN_HEIGHT) |
972f4259 KS |
2611 | { |
2612 | int ph; | |
2613 | ||
2614 | ph = FRAME_X_DISPLAY_INFO (f)->height; | |
5af5757b KS |
2615 | newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph); |
2616 | ph = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, newheight) - f->y_pixels_diff; | |
2617 | newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph); | |
972f4259 KS |
2618 | *top_pos = 0; |
2619 | } | |
dc6f92b8 | 2620 | |
5af5757b | 2621 | if (f->want_fullscreen & FULLSCREEN_WIDTH) |
972f4259 KS |
2622 | { |
2623 | int pw; | |
2624 | ||
2625 | pw = FRAME_X_DISPLAY_INFO (f)->width; | |
5af5757b KS |
2626 | newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw); |
2627 | pw = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, newwidth) - f->x_pixels_diff; | |
2628 | newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw); | |
972f4259 KS |
2629 | *left_pos = 0; |
2630 | } | |
dc6f92b8 | 2631 | |
972f4259 KS |
2632 | *width = newwidth; |
2633 | *height = newheight; | |
2634 | } | |
dc6f92b8 | 2635 | |
beb0bc36 | 2636 | |
972f4259 KS |
2637 | /* Change the parameters of frame F as specified by ALIST. |
2638 | If a parameter is not specially recognized, do nothing special; | |
2639 | otherwise call the `x_set_...' function for that parameter. | |
2640 | Except for certain geometry properties, always call store_frame_param | |
2641 | to store the new value in the parameter alist. */ | |
14ff1ee0 | 2642 | |
972f4259 KS |
2643 | void |
2644 | x_set_frame_parameters (f, alist) | |
2645 | FRAME_PTR f; | |
2646 | Lisp_Object alist; | |
2647 | { | |
2648 | Lisp_Object tail; | |
dc6f92b8 | 2649 | |
972f4259 KS |
2650 | /* If both of these parameters are present, it's more efficient to |
2651 | set them both at once. So we wait until we've looked at the | |
2652 | entire list before we set them. */ | |
2653 | int width, height; | |
3df1fda2 | 2654 | |
972f4259 KS |
2655 | /* Same here. */ |
2656 | Lisp_Object left, top; | |
2657 | ||
2658 | /* Same with these. */ | |
2659 | Lisp_Object icon_left, icon_top; | |
2660 | ||
2661 | /* Record in these vectors all the parms specified. */ | |
2662 | Lisp_Object *parms; | |
2663 | Lisp_Object *values; | |
2664 | int i, p; | |
2665 | int left_no_change = 0, top_no_change = 0; | |
2666 | int icon_left_no_change = 0, icon_top_no_change = 0; | |
2667 | int fullscreen_is_being_set = 0; | |
2668 | ||
2669 | struct gcpro gcpro1, gcpro2; | |
2670 | ||
2671 | i = 0; | |
2672 | for (tail = alist; CONSP (tail); tail = Fcdr (tail)) | |
2673 | i++; | |
2674 | ||
2675 | parms = (Lisp_Object *) alloca (i * sizeof (Lisp_Object)); | |
2676 | values = (Lisp_Object *) alloca (i * sizeof (Lisp_Object)); | |
2677 | ||
2678 | /* Extract parm names and values into those vectors. */ | |
2679 | ||
2680 | i = 0; | |
2681 | for (tail = alist; CONSP (tail); tail = Fcdr (tail)) | |
2682 | { | |
2683 | Lisp_Object elt; | |
2684 | ||
2685 | elt = Fcar (tail); | |
2686 | parms[i] = Fcar (elt); | |
2687 | values[i] = Fcdr (elt); | |
2688 | i++; | |
2689 | } | |
2690 | /* TAIL and ALIST are not used again below here. */ | |
2691 | alist = tail = Qnil; | |
2692 | ||
2693 | GCPRO2 (*parms, *values); | |
2694 | gcpro1.nvars = i; | |
2695 | gcpro2.nvars = i; | |
2696 | ||
2697 | /* There is no need to gcpro LEFT, TOP, ICON_LEFT, or ICON_TOP, | |
2698 | because their values appear in VALUES and strings are not valid. */ | |
2699 | top = left = Qunbound; | |
2700 | icon_left = icon_top = Qunbound; | |
2701 | ||
2702 | /* Provide default values for HEIGHT and WIDTH. */ | |
5af5757b KS |
2703 | width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f)); |
2704 | height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f)); | |
972f4259 KS |
2705 | |
2706 | /* Process foreground_color and background_color before anything else. | |
2707 | They are independent of other properties, but other properties (e.g., | |
2708 | cursor_color) are dependent upon them. */ | |
2709 | /* Process default font as well, since fringe widths depends on it. */ | |
2710 | /* Also, process fullscreen, width and height depend upon that */ | |
2711 | for (p = 0; p < i; p++) | |
2712 | { | |
2713 | Lisp_Object prop, val; | |
2714 | ||
2715 | prop = parms[p]; | |
2716 | val = values[p]; | |
2717 | if (EQ (prop, Qforeground_color) | |
2718 | || EQ (prop, Qbackground_color) | |
2719 | || EQ (prop, Qfont) | |
2720 | || EQ (prop, Qfullscreen)) | |
2721 | { | |
2722 | register Lisp_Object param_index, old_value; | |
2723 | ||
2724 | old_value = get_frame_param (f, prop); | |
2725 | fullscreen_is_being_set |= EQ (prop, Qfullscreen); | |
2726 | ||
2727 | if (NILP (Fequal (val, old_value))) | |
2728 | { | |
2729 | store_frame_param (f, prop, val); | |
2730 | ||
2731 | param_index = Fget (prop, Qx_frame_parameter); | |
2732 | if (NATNUMP (param_index) | |
2733 | && (XFASTINT (param_index) | |
2734 | < sizeof (frame_parms)/sizeof (frame_parms[0])) | |
2735 | && rif->frame_parm_handlers[XINT (param_index)]) | |
2736 | (*(rif->frame_parm_handlers[XINT (param_index)])) (f, val, old_value); | |
2737 | } | |
2738 | } | |
2739 | } | |
2740 | ||
2741 | /* Now process them in reverse of specified order. */ | |
2742 | for (i--; i >= 0; i--) | |
2743 | { | |
2744 | Lisp_Object prop, val; | |
2745 | ||
2746 | prop = parms[i]; | |
2747 | val = values[i]; | |
2748 | ||
2749 | if (EQ (prop, Qwidth) && NUMBERP (val)) | |
2750 | width = XFASTINT (val); | |
2751 | else if (EQ (prop, Qheight) && NUMBERP (val)) | |
2752 | height = XFASTINT (val); | |
2753 | else if (EQ (prop, Qtop)) | |
2754 | top = val; | |
2755 | else if (EQ (prop, Qleft)) | |
2756 | left = val; | |
2757 | else if (EQ (prop, Qicon_top)) | |
2758 | icon_top = val; | |
2759 | else if (EQ (prop, Qicon_left)) | |
2760 | icon_left = val; | |
2761 | else if (EQ (prop, Qforeground_color) | |
2762 | || EQ (prop, Qbackground_color) | |
2763 | || EQ (prop, Qfont) | |
2764 | || EQ (prop, Qfullscreen)) | |
2765 | /* Processed above. */ | |
2766 | continue; | |
2767 | else | |
2768 | { | |
2769 | register Lisp_Object param_index, old_value; | |
2770 | ||
2771 | old_value = get_frame_param (f, prop); | |
2772 | ||
2773 | store_frame_param (f, prop, val); | |
2774 | ||
2775 | param_index = Fget (prop, Qx_frame_parameter); | |
2776 | if (NATNUMP (param_index) | |
2777 | && (XFASTINT (param_index) | |
2778 | < sizeof (frame_parms)/sizeof (frame_parms[0])) | |
2779 | && rif->frame_parm_handlers[XINT (param_index)]) | |
2780 | (*(rif->frame_parm_handlers[XINT (param_index)])) (f, val, old_value); | |
2781 | } | |
2782 | } | |
2783 | ||
2784 | /* Don't die if just one of these was set. */ | |
2785 | if (EQ (left, Qunbound)) | |
2786 | { | |
2787 | left_no_change = 1; | |
5af5757b KS |
2788 | if (f->left_pos < 0) |
2789 | left = Fcons (Qplus, Fcons (make_number (f->left_pos), Qnil)); | |
972f4259 | 2790 | else |
5af5757b | 2791 | XSETINT (left, f->left_pos); |
972f4259 KS |
2792 | } |
2793 | if (EQ (top, Qunbound)) | |
2794 | { | |
2795 | top_no_change = 1; | |
5af5757b KS |
2796 | if (f->top_pos < 0) |
2797 | top = Fcons (Qplus, Fcons (make_number (f->top_pos), Qnil)); | |
972f4259 | 2798 | else |
5af5757b | 2799 | XSETINT (top, f->top_pos); |
972f4259 KS |
2800 | } |
2801 | ||
2802 | /* If one of the icon positions was not set, preserve or default it. */ | |
2803 | if (EQ (icon_left, Qunbound) || ! INTEGERP (icon_left)) | |
2804 | { | |
2805 | icon_left_no_change = 1; | |
2806 | icon_left = Fcdr (Fassq (Qicon_left, f->param_alist)); | |
2807 | if (NILP (icon_left)) | |
2808 | XSETINT (icon_left, 0); | |
2809 | } | |
2810 | if (EQ (icon_top, Qunbound) || ! INTEGERP (icon_top)) | |
2811 | { | |
2812 | icon_top_no_change = 1; | |
2813 | icon_top = Fcdr (Fassq (Qicon_top, f->param_alist)); | |
2814 | if (NILP (icon_top)) | |
2815 | XSETINT (icon_top, 0); | |
2816 | } | |
2817 | ||
972f4259 KS |
2818 | if (FRAME_VISIBLE_P (f) && fullscreen_is_being_set) |
2819 | { | |
2820 | /* If the frame is visible already and the fullscreen parameter is | |
2821 | being set, it is too late to set WM manager hints to specify | |
2822 | size and position. | |
2823 | Here we first get the width, height and position that applies to | |
2824 | fullscreen. We then move the frame to the appropriate | |
2825 | position. Resize of the frame is taken care of in the code after | |
2826 | this if-statement. */ | |
2827 | int new_left, new_top; | |
2828 | ||
2829 | x_fullscreen_adjust (f, &width, &height, &new_top, &new_left); | |
068ae0fd JD |
2830 | if (new_top != f->top_pos || new_left != f->left_pos) |
2831 | x_set_offset (f, new_left, new_top, 1); | |
972f4259 | 2832 | } |
972f4259 KS |
2833 | |
2834 | /* Don't set these parameters unless they've been explicitly | |
2835 | specified. The window might be mapped or resized while we're in | |
2836 | this function, and we don't want to override that unless the lisp | |
2837 | code has asked for it. | |
2838 | ||
2839 | Don't set these parameters unless they actually differ from the | |
2840 | window's current parameters; the window may not actually exist | |
2841 | yet. */ | |
2842 | { | |
2843 | Lisp_Object frame; | |
2844 | ||
2845 | check_frame_size (f, &height, &width); | |
2846 | ||
2847 | XSETFRAME (frame, f); | |
2848 | ||
5af5757b KS |
2849 | if (width != FRAME_COLS (f) |
2850 | || height != FRAME_LINES (f) | |
2851 | || f->new_text_lines || f->new_text_cols) | |
972f4259 KS |
2852 | Fset_frame_size (frame, make_number (width), make_number (height)); |
2853 | ||
2854 | if ((!NILP (left) || !NILP (top)) | |
2855 | && ! (left_no_change && top_no_change) | |
5af5757b KS |
2856 | && ! (NUMBERP (left) && XINT (left) == f->left_pos |
2857 | && NUMBERP (top) && XINT (top) == f->top_pos)) | |
972f4259 KS |
2858 | { |
2859 | int leftpos = 0; | |
2860 | int toppos = 0; | |
2861 | ||
2862 | /* Record the signs. */ | |
5af5757b | 2863 | f->size_hint_flags &= ~ (XNegative | YNegative); |
972f4259 | 2864 | if (EQ (left, Qminus)) |
5af5757b | 2865 | f->size_hint_flags |= XNegative; |
972f4259 KS |
2866 | else if (INTEGERP (left)) |
2867 | { | |
2868 | leftpos = XINT (left); | |
2869 | if (leftpos < 0) | |
5af5757b | 2870 | f->size_hint_flags |= XNegative; |
972f4259 KS |
2871 | } |
2872 | else if (CONSP (left) && EQ (XCAR (left), Qminus) | |
2873 | && CONSP (XCDR (left)) | |
2874 | && INTEGERP (XCAR (XCDR (left)))) | |
2875 | { | |
2876 | leftpos = - XINT (XCAR (XCDR (left))); | |
5af5757b | 2877 | f->size_hint_flags |= XNegative; |
972f4259 KS |
2878 | } |
2879 | else if (CONSP (left) && EQ (XCAR (left), Qplus) | |
2880 | && CONSP (XCDR (left)) | |
2881 | && INTEGERP (XCAR (XCDR (left)))) | |
2882 | { | |
2883 | leftpos = XINT (XCAR (XCDR (left))); | |
2884 | } | |
2885 | ||
2886 | if (EQ (top, Qminus)) | |
5af5757b | 2887 | f->size_hint_flags |= YNegative; |
972f4259 KS |
2888 | else if (INTEGERP (top)) |
2889 | { | |
2890 | toppos = XINT (top); | |
2891 | if (toppos < 0) | |
5af5757b | 2892 | f->size_hint_flags |= YNegative; |
972f4259 KS |
2893 | } |
2894 | else if (CONSP (top) && EQ (XCAR (top), Qminus) | |
2895 | && CONSP (XCDR (top)) | |
2896 | && INTEGERP (XCAR (XCDR (top)))) | |
2897 | { | |
2898 | toppos = - XINT (XCAR (XCDR (top))); | |
5af5757b | 2899 | f->size_hint_flags |= YNegative; |
972f4259 KS |
2900 | } |
2901 | else if (CONSP (top) && EQ (XCAR (top), Qplus) | |
2902 | && CONSP (XCDR (top)) | |
2903 | && INTEGERP (XCAR (XCDR (top)))) | |
2904 | { | |
2905 | toppos = XINT (XCAR (XCDR (top))); | |
2906 | } | |
2907 | ||
2908 | ||
2909 | /* Store the numeric value of the position. */ | |
5af5757b KS |
2910 | f->top_pos = toppos; |
2911 | f->left_pos = leftpos; | |
972f4259 | 2912 | |
5af5757b | 2913 | f->win_gravity = NorthWestGravity; |
972f4259 KS |
2914 | |
2915 | /* Actually set that position, and convert to absolute. */ | |
2916 | x_set_offset (f, leftpos, toppos, -1); | |
2917 | } | |
2918 | ||
2919 | if ((!NILP (icon_left) || !NILP (icon_top)) | |
2920 | && ! (icon_left_no_change && icon_top_no_change)) | |
2921 | x_wm_set_icon_position (f, XINT (icon_left), XINT (icon_top)); | |
2922 | } | |
2923 | ||
2924 | UNGCPRO; | |
2925 | } | |
2926 | ||
2927 | ||
2928 | /* Insert a description of internally-recorded parameters of frame X | |
2929 | into the parameter alist *ALISTPTR that is to be given to the user. | |
2930 | Only parameters that are specific to the X window system | |
2931 | and whose values are not correctly recorded in the frame's | |
2932 | param_alist need to be considered here. */ | |
2933 | ||
2934 | void | |
2935 | x_report_frame_params (f, alistptr) | |
2936 | struct frame *f; | |
2937 | Lisp_Object *alistptr; | |
2938 | { | |
2939 | char buf[16]; | |
2940 | Lisp_Object tem; | |
2941 | ||
2942 | /* Represent negative positions (off the top or left screen edge) | |
2943 | in a way that Fmodify_frame_parameters will understand correctly. */ | |
5af5757b KS |
2944 | XSETINT (tem, f->left_pos); |
2945 | if (f->left_pos >= 0) | |
972f4259 KS |
2946 | store_in_alist (alistptr, Qleft, tem); |
2947 | else | |
2948 | store_in_alist (alistptr, Qleft, Fcons (Qplus, Fcons (tem, Qnil))); | |
2949 | ||
5af5757b KS |
2950 | XSETINT (tem, f->top_pos); |
2951 | if (f->top_pos >= 0) | |
972f4259 KS |
2952 | store_in_alist (alistptr, Qtop, tem); |
2953 | else | |
2954 | store_in_alist (alistptr, Qtop, Fcons (Qplus, Fcons (tem, Qnil))); | |
2955 | ||
2956 | store_in_alist (alistptr, Qborder_width, | |
5af5757b | 2957 | make_number (f->border_width)); |
972f4259 | 2958 | store_in_alist (alistptr, Qinternal_border_width, |
5af5757b | 2959 | make_number (FRAME_INTERNAL_BORDER_WIDTH (f))); |
972f4259 | 2960 | store_in_alist (alistptr, Qleft_fringe, |
5af5757b | 2961 | make_number (FRAME_LEFT_FRINGE_WIDTH (f))); |
972f4259 | 2962 | store_in_alist (alistptr, Qright_fringe, |
5af5757b | 2963 | make_number (FRAME_RIGHT_FRINGE_WIDTH (f))); |
972f4259 KS |
2964 | store_in_alist (alistptr, Qscroll_bar_width, |
2965 | (! FRAME_HAS_VERTICAL_SCROLL_BARS (f) | |
2966 | ? make_number (0) | |
5af5757b KS |
2967 | : FRAME_CONFIG_SCROLL_BAR_WIDTH (f) > 0 |
2968 | ? make_number (FRAME_CONFIG_SCROLL_BAR_WIDTH (f)) | |
972f4259 KS |
2969 | /* nil means "use default width" |
2970 | for non-toolkit scroll bar. | |
2971 | ruler-mode.el depends on this. */ | |
2972 | : Qnil)); | |
2973 | sprintf (buf, "%ld", (long) FRAME_X_WINDOW (f)); | |
2974 | store_in_alist (alistptr, Qwindow_id, | |
2975 | build_string (buf)); | |
2976 | #ifdef HAVE_X_WINDOWS | |
2977 | #ifdef USE_X_TOOLKIT | |
2978 | /* Tooltip frame may not have this widget. */ | |
2979 | if (FRAME_X_OUTPUT (f)->widget) | |
2980 | #endif | |
2981 | sprintf (buf, "%ld", (long) FRAME_OUTER_WINDOW (f)); | |
2982 | store_in_alist (alistptr, Qouter_window_id, | |
2983 | build_string (buf)); | |
2984 | #endif | |
2985 | store_in_alist (alistptr, Qicon_name, f->icon_name); | |
2986 | FRAME_SAMPLE_VISIBILITY (f); | |
2987 | store_in_alist (alistptr, Qvisibility, | |
2988 | (FRAME_VISIBLE_P (f) ? Qt | |
2989 | : FRAME_ICONIFIED_P (f) ? Qicon : Qnil)); | |
2990 | store_in_alist (alistptr, Qdisplay, | |
2991 | XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element)); | |
2992 | ||
2993 | if (FRAME_X_OUTPUT (f)->parent_desc == FRAME_X_DISPLAY_INFO (f)->root_window) | |
2994 | tem = Qnil; | |
2995 | else | |
2996 | XSETFASTINT (tem, FRAME_X_OUTPUT (f)->parent_desc); | |
2997 | store_in_alist (alistptr, Qparent_id, tem); | |
2998 | } | |
2999 | ||
3000 | ||
3001 | /* Change the `fullscreen' frame parameter of frame F. OLD_VALUE is | |
3002 | the previous value of that parameter, NEW_VALUE is the new value. */ | |
3003 | ||
3004 | void | |
3005 | x_set_fullscreen (f, new_value, old_value) | |
3006 | struct frame *f; | |
3007 | Lisp_Object new_value, old_value; | |
3008 | { | |
972f4259 | 3009 | if (NILP (new_value)) |
5af5757b | 3010 | f->want_fullscreen = FULLSCREEN_NONE; |
972f4259 | 3011 | else if (EQ (new_value, Qfullboth)) |
5af5757b | 3012 | f->want_fullscreen = FULLSCREEN_BOTH; |
972f4259 | 3013 | else if (EQ (new_value, Qfullwidth)) |
5af5757b | 3014 | f->want_fullscreen = FULLSCREEN_WIDTH; |
972f4259 | 3015 | else if (EQ (new_value, Qfullheight)) |
5af5757b | 3016 | f->want_fullscreen = FULLSCREEN_HEIGHT; |
972f4259 KS |
3017 | } |
3018 | ||
3019 | ||
3020 | /* Change the `line-spacing' frame parameter of frame F. OLD_VALUE is | |
3021 | the previous value of that parameter, NEW_VALUE is the new value. */ | |
3022 | ||
3023 | void | |
3024 | x_set_line_spacing (f, new_value, old_value) | |
3025 | struct frame *f; | |
3026 | Lisp_Object new_value, old_value; | |
3027 | { | |
3028 | if (NILP (new_value)) | |
3029 | f->extra_line_spacing = 0; | |
3030 | else if (NATNUMP (new_value)) | |
3031 | f->extra_line_spacing = XFASTINT (new_value); | |
3032 | else | |
3033 | Fsignal (Qerror, Fcons (build_string ("Invalid line-spacing"), | |
3034 | Fcons (new_value, Qnil))); | |
3035 | if (FRAME_VISIBLE_P (f)) | |
3036 | redraw_frame (f); | |
3037 | } | |
3038 | ||
3039 | ||
3040 | /* Change the `screen-gamma' frame parameter of frame F. OLD_VALUE is | |
3041 | the previous value of that parameter, NEW_VALUE is the new value. */ | |
3042 | ||
3043 | void | |
3044 | x_set_screen_gamma (f, new_value, old_value) | |
3045 | struct frame *f; | |
3046 | Lisp_Object new_value, old_value; | |
3047 | { | |
3048 | if (NILP (new_value)) | |
3049 | f->gamma = 0; | |
3050 | else if (NUMBERP (new_value) && XFLOATINT (new_value) > 0) | |
3051 | /* The value 0.4545 is the normal viewing gamma. */ | |
3052 | f->gamma = 1.0 / (0.4545 * XFLOATINT (new_value)); | |
3053 | else | |
3054 | Fsignal (Qerror, Fcons (build_string ("Invalid screen-gamma"), | |
3055 | Fcons (new_value, Qnil))); | |
3056 | ||
3057 | clear_face_cache (0); | |
3058 | } | |
3059 | ||
3060 | ||
3061 | void | |
3062 | x_set_font (f, arg, oldval) | |
3063 | struct frame *f; | |
3064 | Lisp_Object arg, oldval; | |
3065 | { | |
3066 | Lisp_Object result; | |
3067 | Lisp_Object fontset_name; | |
3068 | Lisp_Object frame; | |
3069 | int old_fontset = FRAME_FONTSET(f); | |
3070 | ||
3071 | CHECK_STRING (arg); | |
3072 | ||
3073 | fontset_name = Fquery_fontset (arg, Qnil); | |
3074 | ||
3075 | BLOCK_INPUT; | |
3076 | result = (STRINGP (fontset_name) | |
3077 | ? x_new_fontset (f, SDATA (fontset_name)) | |
3078 | : x_new_font (f, SDATA (arg))); | |
3079 | UNBLOCK_INPUT; | |
3080 | ||
3081 | if (EQ (result, Qnil)) | |
3082 | error ("Font `%s' is not defined", SDATA (arg)); | |
3083 | else if (EQ (result, Qt)) | |
3084 | error ("The characters of the given font have varying widths"); | |
3085 | else if (STRINGP (result)) | |
3086 | { | |
ee5d57b0 | 3087 | set_default_ascii_font (result); |
972f4259 KS |
3088 | if (STRINGP (fontset_name)) |
3089 | { | |
3090 | /* Fontset names are built from ASCII font names, so the | |
3091 | names may be equal despite there was a change. */ | |
3092 | if (old_fontset == FRAME_FONTSET (f)) | |
3093 | return; | |
3094 | } | |
3095 | else if (!NILP (Fequal (result, oldval))) | |
3096 | return; | |
3097 | ||
ca03f883 KS |
3098 | /* Recalculate toolbar height. */ |
3099 | f->n_tool_bar_rows = 0; | |
3100 | /* Ensure we redraw it. */ | |
3101 | clear_current_matrices (f); | |
3102 | ||
972f4259 KS |
3103 | store_frame_param (f, Qfont, result); |
3104 | recompute_basic_faces (f); | |
3105 | } | |
3106 | else | |
3107 | abort (); | |
3108 | ||
3109 | do_pending_window_change (0); | |
3110 | ||
3111 | /* Don't call `face-set-after-frame-default' when faces haven't been | |
3112 | initialized yet. This is the case when called from | |
3113 | Fx_create_frame. In that case, the X widget or window doesn't | |
3114 | exist either, and we can end up in x_report_frame_params with a | |
3115 | null widget which gives a segfault. */ | |
3116 | if (FRAME_FACE_CACHE (f)) | |
3117 | { | |
3118 | XSETFRAME (frame, f); | |
3119 | call1 (Qface_set_after_frame_default, frame); | |
3120 | } | |
3121 | } | |
3122 | ||
3123 | ||
3124 | void | |
3125 | x_set_fringe_width (f, new_value, old_value) | |
3126 | struct frame *f; | |
3127 | Lisp_Object new_value, old_value; | |
3128 | { | |
3129 | compute_fringe_widths (f, 1); | |
3130 | } | |
3131 | ||
3132 | void | |
3133 | x_set_border_width (f, arg, oldval) | |
3134 | struct frame *f; | |
3135 | Lisp_Object arg, oldval; | |
3136 | { | |
3137 | CHECK_NUMBER (arg); | |
3138 | ||
5af5757b | 3139 | if (XINT (arg) == f->border_width) |
972f4259 KS |
3140 | return; |
3141 | ||
972f4259 | 3142 | if (FRAME_X_WINDOW (f) != 0) |
dac85f4b | 3143 | error ("Cannot change the border width of a frame"); |
972f4259 | 3144 | |
5af5757b | 3145 | f->border_width = XINT (arg); |
972f4259 KS |
3146 | } |
3147 | ||
3148 | void | |
3149 | x_set_internal_border_width (f, arg, oldval) | |
3150 | struct frame *f; | |
3151 | Lisp_Object arg, oldval; | |
3152 | { | |
5af5757b | 3153 | int old = FRAME_INTERNAL_BORDER_WIDTH (f); |
972f4259 KS |
3154 | |
3155 | CHECK_NUMBER (arg); | |
5af5757b KS |
3156 | FRAME_INTERNAL_BORDER_WIDTH (f) = XINT (arg); |
3157 | if (FRAME_INTERNAL_BORDER_WIDTH (f) < 0) | |
3158 | FRAME_INTERNAL_BORDER_WIDTH (f) = 0; | |
972f4259 KS |
3159 | |
3160 | #ifdef USE_X_TOOLKIT | |
3161 | if (FRAME_X_OUTPUT (f)->edit_widget) | |
3162 | widget_store_internal_border (FRAME_X_OUTPUT (f)->edit_widget); | |
3163 | #endif | |
3164 | ||
5af5757b | 3165 | if (FRAME_INTERNAL_BORDER_WIDTH (f) == old) |
972f4259 KS |
3166 | return; |
3167 | ||
3168 | if (FRAME_X_WINDOW (f) != 0) | |
3169 | { | |
5af5757b | 3170 | x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f)); |
972f4259 KS |
3171 | SET_FRAME_GARBAGED (f); |
3172 | do_pending_window_change (0); | |
3173 | } | |
3174 | else | |
3175 | SET_FRAME_GARBAGED (f); | |
3176 | } | |
3177 | ||
3178 | void | |
3179 | x_set_visibility (f, value, oldval) | |
3180 | struct frame *f; | |
3181 | Lisp_Object value, oldval; | |
3182 | { | |
3183 | Lisp_Object frame; | |
3184 | XSETFRAME (frame, f); | |
3185 | ||
3186 | if (NILP (value)) | |
3187 | Fmake_frame_invisible (frame, Qt); | |
3188 | else if (EQ (value, Qicon)) | |
3189 | Ficonify_frame (frame); | |
3190 | else | |
3191 | Fmake_frame_visible (frame); | |
3192 | } | |
3193 | ||
3194 | void | |
3195 | x_set_autoraise (f, arg, oldval) | |
3196 | struct frame *f; | |
3197 | Lisp_Object arg, oldval; | |
3198 | { | |
3199 | f->auto_raise = !EQ (Qnil, arg); | |
3200 | } | |
3201 | ||
3202 | void | |
3203 | x_set_autolower (f, arg, oldval) | |
3204 | struct frame *f; | |
3205 | Lisp_Object arg, oldval; | |
3206 | { | |
3207 | f->auto_lower = !EQ (Qnil, arg); | |
3208 | } | |
3209 | ||
3210 | void | |
3211 | x_set_unsplittable (f, arg, oldval) | |
3212 | struct frame *f; | |
3213 | Lisp_Object arg, oldval; | |
3214 | { | |
3215 | f->no_split = !NILP (arg); | |
3216 | } | |
3217 | ||
3218 | void | |
3219 | x_set_vertical_scroll_bars (f, arg, oldval) | |
3220 | struct frame *f; | |
3221 | Lisp_Object arg, oldval; | |
3222 | { | |
3223 | if ((EQ (arg, Qleft) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f)) | |
3224 | || (EQ (arg, Qright) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f)) | |
3225 | || (NILP (arg) && FRAME_HAS_VERTICAL_SCROLL_BARS (f)) | |
3226 | || (!NILP (arg) && ! FRAME_HAS_VERTICAL_SCROLL_BARS (f))) | |
3227 | { | |
3228 | FRAME_VERTICAL_SCROLL_BAR_TYPE (f) | |
3229 | = (NILP (arg) | |
3230 | ? vertical_scroll_bar_none | |
3231 | : EQ (Qleft, arg) | |
3232 | ? vertical_scroll_bar_left | |
3233 | : EQ (Qright, arg) | |
3234 | ? vertical_scroll_bar_right | |
a6e20602 KS |
3235 | : EQ (Qleft, Vdefault_frame_scroll_bars) |
3236 | ? vertical_scroll_bar_left | |
3237 | : EQ (Qright, Vdefault_frame_scroll_bars) | |
3238 | ? vertical_scroll_bar_right | |
3239 | : vertical_scroll_bar_none); | |
972f4259 KS |
3240 | |
3241 | /* We set this parameter before creating the X window for the | |
3242 | frame, so we can get the geometry right from the start. | |
3243 | However, if the window hasn't been created yet, we shouldn't | |
3244 | call x_set_window_size. */ | |
3245 | if (FRAME_X_WINDOW (f)) | |
5af5757b | 3246 | x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f)); |
972f4259 KS |
3247 | do_pending_window_change (0); |
3248 | } | |
3249 | } | |
3250 | ||
3251 | void | |
3252 | x_set_scroll_bar_width (f, arg, oldval) | |
3253 | struct frame *f; | |
3254 | Lisp_Object arg, oldval; | |
3255 | { | |
5af5757b | 3256 | int wid = FRAME_COLUMN_WIDTH (f); |
972f4259 KS |
3257 | |
3258 | if (NILP (arg)) | |
3259 | { | |
3260 | x_set_scroll_bar_default_width (f); | |
3261 | ||
3262 | if (FRAME_X_WINDOW (f)) | |
5af5757b | 3263 | x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f)); |
972f4259 KS |
3264 | do_pending_window_change (0); |
3265 | } | |
3266 | else if (INTEGERP (arg) && XINT (arg) > 0 | |
5af5757b | 3267 | && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_WIDTH (f)) |
972f4259 KS |
3268 | { |
3269 | if (XFASTINT (arg) <= 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM) | |
3270 | XSETINT (arg, 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM + 1); | |
3271 | ||
5af5757b KS |
3272 | FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = XFASTINT (arg); |
3273 | FRAME_CONFIG_SCROLL_BAR_COLS (f) = (XFASTINT (arg) + wid-1) / wid; | |
972f4259 | 3274 | if (FRAME_X_WINDOW (f)) |
5af5757b | 3275 | x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f)); |
972f4259 KS |
3276 | do_pending_window_change (0); |
3277 | } | |
3278 | ||
5af5757b | 3279 | change_frame_size (f, 0, FRAME_COLS (f), 0, 0, 0); |
972f4259 KS |
3280 | XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.hpos = 0; |
3281 | XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.x = 0; | |
3282 | } | |
3283 | ||
3284 | ||
3285 | ||
3286 | /* Return non-nil if frame F wants a bitmap icon. */ | |
3287 | ||
3288 | Lisp_Object | |
3289 | x_icon_type (f) | |
3290 | FRAME_PTR f; | |
3291 | { | |
3292 | Lisp_Object tem; | |
3293 | ||
3294 | tem = assq_no_quit (Qicon_type, f->param_alist); | |
3295 | if (CONSP (tem)) | |
3296 | return XCDR (tem); | |
3297 | else | |
3298 | return Qnil; | |
3299 | } | |
3300 | ||
3301 | \f | |
3302 | /* Subroutines of creating an X frame. */ | |
3303 | ||
3304 | /* Make sure that Vx_resource_name is set to a reasonable value. | |
3305 | Fix it up, or set it to `emacs' if it is too hopeless. */ | |
3306 | ||
3307 | void | |
3308 | validate_x_resource_name () | |
3309 | { | |
3310 | int len = 0; | |
3311 | /* Number of valid characters in the resource name. */ | |
3312 | int good_count = 0; | |
3313 | /* Number of invalid characters in the resource name. */ | |
3314 | int bad_count = 0; | |
3315 | Lisp_Object new; | |
3316 | int i; | |
3317 | ||
3318 | if (!STRINGP (Vx_resource_class)) | |
3319 | Vx_resource_class = build_string (EMACS_CLASS); | |
3320 | ||
3321 | if (STRINGP (Vx_resource_name)) | |
3322 | { | |
3323 | unsigned char *p = SDATA (Vx_resource_name); | |
3324 | int i; | |
3325 | ||
3326 | len = SBYTES (Vx_resource_name); | |
3327 | ||
3328 | /* Only letters, digits, - and _ are valid in resource names. | |
3329 | Count the valid characters and count the invalid ones. */ | |
3330 | for (i = 0; i < len; i++) | |
3331 | { | |
3332 | int c = p[i]; | |
3333 | if (! ((c >= 'a' && c <= 'z') | |
3334 | || (c >= 'A' && c <= 'Z') | |
3335 | || (c >= '0' && c <= '9') | |
3336 | || c == '-' || c == '_')) | |
3337 | bad_count++; | |
3338 | else | |
3339 | good_count++; | |
3340 | } | |
3341 | } | |
3342 | else | |
3343 | /* Not a string => completely invalid. */ | |
3344 | bad_count = 5, good_count = 0; | |
3345 | ||
3346 | /* If name is valid already, return. */ | |
3347 | if (bad_count == 0) | |
3348 | return; | |
3349 | ||
3350 | /* If name is entirely invalid, or nearly so, use `emacs'. */ | |
3351 | if (good_count == 0 | |
3352 | || (good_count == 1 && bad_count > 0)) | |
3353 | { | |
3354 | Vx_resource_name = build_string ("emacs"); | |
3355 | return; | |
3356 | } | |
3357 | ||
3358 | /* Name is partly valid. Copy it and replace the invalid characters | |
3359 | with underscores. */ | |
3360 | ||
3361 | Vx_resource_name = new = Fcopy_sequence (Vx_resource_name); | |
3362 | ||
3363 | for (i = 0; i < len; i++) | |
3364 | { | |
3365 | int c = SREF (new, i); | |
3366 | if (! ((c >= 'a' && c <= 'z') | |
3367 | || (c >= 'A' && c <= 'Z') | |
3368 | || (c >= '0' && c <= '9') | |
3369 | || c == '-' || c == '_')) | |
3370 | SSET (new, i, '_'); | |
3371 | } | |
3372 | } | |
3373 | ||
3374 | ||
3375 | extern char *x_get_string_resource P_ ((XrmDatabase, char *, char *)); | |
3376 | extern Display_Info *check_x_display_info P_ ((Lisp_Object)); | |
3377 | ||
3378 | ||
b5251fe7 | 3379 | /* Get specified attribute from resource database RDB. |
972f4259 KS |
3380 | See Fx_get_resource below for other parameters. */ |
3381 | ||
3382 | static Lisp_Object | |
3383 | xrdb_get_resource (rdb, attribute, class, component, subclass) | |
3384 | XrmDatabase rdb; | |
3385 | Lisp_Object attribute, class, component, subclass; | |
3386 | { | |
3387 | register char *value; | |
3388 | char *name_key; | |
3389 | char *class_key; | |
3390 | ||
3391 | CHECK_STRING (attribute); | |
3392 | CHECK_STRING (class); | |
3393 | ||
3394 | if (!NILP (component)) | |
3395 | CHECK_STRING (component); | |
3396 | if (!NILP (subclass)) | |
3397 | CHECK_STRING (subclass); | |
3398 | if (NILP (component) != NILP (subclass)) | |
3399 | error ("x-get-resource: must specify both COMPONENT and SUBCLASS or neither"); | |
3400 | ||
3401 | validate_x_resource_name (); | |
3402 | ||
3403 | /* Allocate space for the components, the dots which separate them, | |
3404 | and the final '\0'. Make them big enough for the worst case. */ | |
3405 | name_key = (char *) alloca (SBYTES (Vx_resource_name) | |
3406 | + (STRINGP (component) | |
3407 | ? SBYTES (component) : 0) | |
3408 | + SBYTES (attribute) | |
3409 | + 3); | |
3410 | ||
3411 | class_key = (char *) alloca (SBYTES (Vx_resource_class) | |
3412 | + SBYTES (class) | |
3413 | + (STRINGP (subclass) | |
3414 | ? SBYTES (subclass) : 0) | |
3415 | + 3); | |
3416 | ||
3417 | /* Start with emacs.FRAMENAME for the name (the specific one) | |
3418 | and with `Emacs' for the class key (the general one). */ | |
3419 | strcpy (name_key, SDATA (Vx_resource_name)); | |
3420 | strcpy (class_key, SDATA (Vx_resource_class)); | |
3421 | ||
3422 | strcat (class_key, "."); | |
3423 | strcat (class_key, SDATA (class)); | |
3424 | ||
3425 | if (!NILP (component)) | |
3426 | { | |
3427 | strcat (class_key, "."); | |
3428 | strcat (class_key, SDATA (subclass)); | |
3429 | ||
3430 | strcat (name_key, "."); | |
3431 | strcat (name_key, SDATA (component)); | |
3432 | } | |
3433 | ||
3434 | strcat (name_key, "."); | |
3435 | strcat (name_key, SDATA (attribute)); | |
3436 | ||
3437 | value = x_get_string_resource (rdb, name_key, class_key); | |
3438 | ||
3439 | if (value != (char *) 0) | |
3440 | return build_string (value); | |
3441 | else | |
3442 | return Qnil; | |
3443 | } | |
3444 | ||
3445 | ||
3446 | DEFUN ("x-get-resource", Fx_get_resource, Sx_get_resource, 2, 4, 0, | |
3447 | doc: /* Return the value of ATTRIBUTE, of class CLASS, from the X defaults database. | |
3448 | This uses `INSTANCE.ATTRIBUTE' as the key and `Emacs.CLASS' as the | |
3449 | class, where INSTANCE is the name under which Emacs was invoked, or | |
3450 | the name specified by the `-name' or `-rn' command-line arguments. | |
3451 | ||
3452 | The optional arguments COMPONENT and SUBCLASS add to the key and the | |
3453 | class, respectively. You must specify both of them or neither. | |
3454 | If you specify them, the key is `INSTANCE.COMPONENT.ATTRIBUTE' | |
3455 | and the class is `Emacs.CLASS.SUBCLASS'. */) | |
3456 | (attribute, class, component, subclass) | |
3457 | Lisp_Object attribute, class, component, subclass; | |
3458 | { | |
3459 | #ifdef HAVE_X_WINDOWS | |
3460 | check_x (); | |
3461 | #endif | |
3462 | ||
3463 | return xrdb_get_resource (check_x_display_info (Qnil)->xrdb, | |
3464 | attribute, class, component, subclass); | |
3465 | } | |
3466 | ||
3467 | /* Get an X resource, like Fx_get_resource, but for display DPYINFO. */ | |
3468 | ||
3469 | Lisp_Object | |
3470 | display_x_get_resource (dpyinfo, attribute, class, component, subclass) | |
a1702920 | 3471 | Display_Info *dpyinfo; |
972f4259 KS |
3472 | Lisp_Object attribute, class, component, subclass; |
3473 | { | |
3474 | return xrdb_get_resource (dpyinfo->xrdb, | |
3475 | attribute, class, component, subclass); | |
3476 | } | |
3477 | ||
3478 | /* Used when C code wants a resource value. */ | |
3479 | ||
3480 | char * | |
3481 | x_get_resource_string (attribute, class) | |
3482 | char *attribute, *class; | |
3483 | { | |
3484 | char *name_key; | |
3485 | char *class_key; | |
3486 | struct frame *sf = SELECTED_FRAME (); | |
3487 | ||
3488 | /* Allocate space for the components, the dots which separate them, | |
3489 | and the final '\0'. */ | |
3490 | name_key = (char *) alloca (SBYTES (Vinvocation_name) | |
3491 | + strlen (attribute) + 2); | |
3492 | class_key = (char *) alloca ((sizeof (EMACS_CLASS) - 1) | |
3493 | + strlen (class) + 2); | |
3494 | ||
3495 | sprintf (name_key, "%s.%s", SDATA (Vinvocation_name), attribute); | |
3496 | sprintf (class_key, "%s.%s", EMACS_CLASS, class); | |
3497 | ||
3498 | return x_get_string_resource (FRAME_X_DISPLAY_INFO (sf)->xrdb, | |
3499 | name_key, class_key); | |
3500 | } | |
3501 | ||
3502 | ||
3503 | /* Return the value of parameter PARAM. | |
3504 | ||
3505 | First search ALIST, then Vdefault_frame_alist, then the X defaults | |
3506 | database, using ATTRIBUTE as the attribute name and CLASS as its class. | |
3507 | ||
3508 | Convert the resource to the type specified by desired_type. | |
3509 | ||
3510 | If no default is specified, return Qunbound. If you call | |
3511 | x_get_arg, make sure you deal with Qunbound in a reasonable way, | |
3512 | and don't let it get stored in any Lisp-visible variables! */ | |
3513 | ||
3514 | Lisp_Object | |
3515 | x_get_arg (dpyinfo, alist, param, attribute, class, type) | |
b5251fe7 | 3516 | Display_Info *dpyinfo; |
972f4259 KS |
3517 | Lisp_Object alist, param; |
3518 | char *attribute; | |
3519 | char *class; | |
3520 | enum resource_types type; | |
3521 | { | |
3522 | register Lisp_Object tem; | |
3523 | ||
3524 | tem = Fassq (param, alist); | |
d00368cf RS |
3525 | |
3526 | if (!NILP (tem)) | |
3527 | { | |
3528 | /* If we find this parm in ALIST, clear it out | |
3529 | so that it won't be "left over" at the end. */ | |
58ec2913 | 3530 | #ifndef WINDOWSNT /* w32fns.c has not yet been changed to cope with this. */ |
5f694926 | 3531 | Lisp_Object tail; |
d00368cf | 3532 | XSETCAR (tem, Qnil); |
5f694926 RS |
3533 | /* In case the parameter appears more than once in the alist, |
3534 | clear it out. */ | |
3535 | for (tail = alist; CONSP (tail); tail = XCDR (tail)) | |
3536 | if (CONSP (XCAR (tail)) | |
3537 | && EQ (XCAR (XCAR (tail)), param)) | |
3538 | XSETCAR (XCAR (tail), Qnil); | |
d00368cf RS |
3539 | #endif |
3540 | } | |
3541 | else | |
972f4259 | 3542 | tem = Fassq (param, Vdefault_frame_alist); |
d00368cf RS |
3543 | |
3544 | /* If it wasn't specified in ALIST or the Lisp-level defaults, | |
3545 | look in the X resources. */ | |
972f4259 KS |
3546 | if (EQ (tem, Qnil)) |
3547 | { | |
3548 | if (attribute) | |
3549 | { | |
3550 | tem = display_x_get_resource (dpyinfo, | |
3551 | build_string (attribute), | |
3552 | build_string (class), | |
3553 | Qnil, Qnil); | |
3554 | ||
3555 | if (NILP (tem)) | |
3556 | return Qunbound; | |
3557 | ||
3558 | switch (type) | |
3559 | { | |
3560 | case RES_TYPE_NUMBER: | |
3561 | return make_number (atoi (SDATA (tem))); | |
3562 | ||
3563 | case RES_TYPE_FLOAT: | |
3564 | return make_float (atof (SDATA (tem))); | |
3565 | ||
3566 | case RES_TYPE_BOOLEAN: | |
3567 | tem = Fdowncase (tem); | |
3568 | if (!strcmp (SDATA (tem), "on") | |
3569 | || !strcmp (SDATA (tem), "true")) | |
3570 | return Qt; | |
3571 | else | |
3572 | return Qnil; | |
3573 | ||
3574 | case RES_TYPE_STRING: | |
3575 | return tem; | |
3576 | ||
3577 | case RES_TYPE_SYMBOL: | |
3578 | /* As a special case, we map the values `true' and `on' | |
3579 | to Qt, and `false' and `off' to Qnil. */ | |
3580 | { | |
3581 | Lisp_Object lower; | |
3582 | lower = Fdowncase (tem); | |
3583 | if (!strcmp (SDATA (lower), "on") | |
3584 | || !strcmp (SDATA (lower), "true")) | |
3585 | return Qt; | |
3586 | else if (!strcmp (SDATA (lower), "off") | |
3587 | || !strcmp (SDATA (lower), "false")) | |
3588 | return Qnil; | |
3589 | else | |
3590 | return Fintern (tem, Qnil); | |
3591 | } | |
3592 | ||
3593 | default: | |
3594 | abort (); | |
3595 | } | |
3596 | } | |
3597 | else | |
3598 | return Qunbound; | |
3599 | } | |
3600 | return Fcdr (tem); | |
3601 | } | |
3602 | ||
3603 | Lisp_Object | |
3604 | x_frame_get_arg (f, alist, param, attribute, class, type) | |
3605 | struct frame *f; | |
3606 | Lisp_Object alist, param; | |
3607 | char *attribute; | |
3608 | char *class; | |
3609 | enum resource_types type; | |
3610 | { | |
3611 | return x_get_arg (FRAME_X_DISPLAY_INFO (f), | |
3612 | alist, param, attribute, class, type); | |
3613 | } | |
3614 | ||
3615 | /* Like x_frame_get_arg, but also record the value in f->param_alist. */ | |
3616 | ||
3617 | Lisp_Object | |
3618 | x_frame_get_and_record_arg (f, alist, param, attribute, class, type) | |
3619 | struct frame *f; | |
3620 | Lisp_Object alist, param; | |
3621 | char *attribute; | |
3622 | char *class; | |
3623 | enum resource_types type; | |
3624 | { | |
3625 | Lisp_Object value; | |
3626 | ||
3627 | value = x_get_arg (FRAME_X_DISPLAY_INFO (f), alist, param, | |
3628 | attribute, class, type); | |
edd1c685 | 3629 | if (! NILP (value) && ! EQ (value, Qunbound)) |
972f4259 KS |
3630 | store_frame_param (f, param, value); |
3631 | ||
3632 | return value; | |
3633 | } | |
3634 | ||
3635 | ||
3636 | /* Record in frame F the specified or default value according to ALIST | |
3637 | of the parameter named PROP (a Lisp symbol). | |
3638 | If no value is specified for PROP, look for an X default for XPROP | |
3639 | on the frame named NAME. | |
3640 | If that is not found either, use the value DEFLT. */ | |
3641 | ||
3642 | Lisp_Object | |
3643 | x_default_parameter (f, alist, prop, deflt, xprop, xclass, type) | |
3644 | struct frame *f; | |
3645 | Lisp_Object alist; | |
3646 | Lisp_Object prop; | |
3647 | Lisp_Object deflt; | |
3648 | char *xprop; | |
3649 | char *xclass; | |
3650 | enum resource_types type; | |
3651 | { | |
3652 | Lisp_Object tem; | |
3653 | ||
3654 | tem = x_frame_get_arg (f, alist, prop, xprop, xclass, type); | |
3655 | if (EQ (tem, Qunbound)) | |
3656 | tem = deflt; | |
3657 | x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil)); | |
3658 | return tem; | |
3659 | } | |
3660 | ||
3661 | ||
3662 | ||
3663 | \f | |
3664 | DEFUN ("x-parse-geometry", Fx_parse_geometry, Sx_parse_geometry, 1, 1, 0, | |
3665 | doc: /* Parse an X-style geometry string STRING. | |
3666 | Returns an alist of the form ((top . TOP), (left . LEFT) ... ). | |
3667 | The properties returned may include `top', `left', `height', and `width'. | |
3668 | The value of `left' or `top' may be an integer, | |
3669 | or a list (+ N) meaning N pixels relative to top/left corner, | |
3670 | or a list (- N) meaning -N pixels relative to bottom/right corner. */) | |
3671 | (string) | |
3672 | Lisp_Object string; | |
3673 | { | |
3674 | int geometry, x, y; | |
3675 | unsigned int width, height; | |
3676 | Lisp_Object result; | |
3677 | ||
3678 | CHECK_STRING (string); | |
3679 | ||
3680 | geometry = XParseGeometry ((char *) SDATA (string), | |
3681 | &x, &y, &width, &height); | |
3682 | ||
3683 | #if 0 | |
3684 | if (!!(geometry & XValue) != !!(geometry & YValue)) | |
3685 | error ("Must specify both x and y position, or neither"); | |
3686 | #endif | |
3687 | ||
3688 | result = Qnil; | |
3689 | if (geometry & XValue) | |
3690 | { | |
3691 | Lisp_Object element; | |
3692 | ||
3693 | if (x >= 0 && (geometry & XNegative)) | |
3694 | element = Fcons (Qleft, Fcons (Qminus, Fcons (make_number (-x), Qnil))); | |
3695 | else if (x < 0 && ! (geometry & XNegative)) | |
3696 | element = Fcons (Qleft, Fcons (Qplus, Fcons (make_number (x), Qnil))); | |
3697 | else | |
3698 | element = Fcons (Qleft, make_number (x)); | |
3699 | result = Fcons (element, result); | |
3700 | } | |
3701 | ||
3702 | if (geometry & YValue) | |
3703 | { | |
3704 | Lisp_Object element; | |
3705 | ||
3706 | if (y >= 0 && (geometry & YNegative)) | |
3707 | element = Fcons (Qtop, Fcons (Qminus, Fcons (make_number (-y), Qnil))); | |
3708 | else if (y < 0 && ! (geometry & YNegative)) | |
3709 | element = Fcons (Qtop, Fcons (Qplus, Fcons (make_number (y), Qnil))); | |
3710 | else | |
3711 | element = Fcons (Qtop, make_number (y)); | |
3712 | result = Fcons (element, result); | |
3713 | } | |
3714 | ||
3715 | if (geometry & WidthValue) | |
3716 | result = Fcons (Fcons (Qwidth, make_number (width)), result); | |
3717 | if (geometry & HeightValue) | |
3718 | result = Fcons (Fcons (Qheight, make_number (height)), result); | |
3719 | ||
3720 | return result; | |
3721 | } | |
3722 | ||
3723 | /* Calculate the desired size and position of frame F. | |
3724 | Return the flags saying which aspects were specified. | |
3725 | ||
3726 | Also set the win_gravity and size_hint_flags of F. | |
3727 | ||
3728 | Adjust height for toolbar if TOOLBAR_P is 1. | |
3729 | ||
3730 | This function does not make the coordinates positive. */ | |
3731 | ||
3732 | #define DEFAULT_ROWS 40 | |
3733 | #define DEFAULT_COLS 80 | |
3734 | ||
3735 | int | |
3736 | x_figure_window_size (f, parms, toolbar_p) | |
3737 | struct frame *f; | |
3738 | Lisp_Object parms; | |
3739 | int toolbar_p; | |
3740 | { | |
3741 | register Lisp_Object tem0, tem1, tem2; | |
3742 | long window_prompting = 0; | |
3743 | Display_Info *dpyinfo = FRAME_X_DISPLAY_INFO (f); | |
3744 | ||
3745 | /* Default values if we fall through. | |
3746 | Actually, if that happens we should get | |
3747 | window manager prompting. */ | |
5af5757b KS |
3748 | SET_FRAME_COLS (f, DEFAULT_COLS); |
3749 | FRAME_LINES (f) = DEFAULT_ROWS; | |
972f4259 KS |
3750 | /* Window managers expect that if program-specified |
3751 | positions are not (0,0), they're intentional, not defaults. */ | |
5af5757b KS |
3752 | f->top_pos = 0; |
3753 | f->left_pos = 0; | |
972f4259 | 3754 | |
5af5757b | 3755 | /* Ensure that old new_text_cols and new_text_lines will not override the |
972f4259 KS |
3756 | values set here. */ |
3757 | /* ++KFS: This was specific to W32, but seems ok for all platforms */ | |
5af5757b | 3758 | f->new_text_cols = f->new_text_lines = 0; |
972f4259 KS |
3759 | |
3760 | tem0 = x_get_arg (dpyinfo, parms, Qheight, 0, 0, RES_TYPE_NUMBER); | |
3761 | tem1 = x_get_arg (dpyinfo, parms, Qwidth, 0, 0, RES_TYPE_NUMBER); | |
3762 | tem2 = x_get_arg (dpyinfo, parms, Quser_size, 0, 0, RES_TYPE_NUMBER); | |
3763 | if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound)) | |
3764 | { | |
3765 | if (!EQ (tem0, Qunbound)) | |
3766 | { | |
3767 | CHECK_NUMBER (tem0); | |
5af5757b | 3768 | FRAME_LINES (f) = XINT (tem0); |
972f4259 KS |
3769 | } |
3770 | if (!EQ (tem1, Qunbound)) | |
3771 | { | |
3772 | CHECK_NUMBER (tem1); | |
5af5757b | 3773 | SET_FRAME_COLS (f, XINT (tem1)); |
972f4259 KS |
3774 | } |
3775 | if (!NILP (tem2) && !EQ (tem2, Qunbound)) | |
3776 | window_prompting |= USSize; | |
3777 | else | |
3778 | window_prompting |= PSize; | |
3779 | } | |
3780 | ||
5af5757b KS |
3781 | f->scroll_bar_actual_width |
3782 | = FRAME_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f); | |
972f4259 KS |
3783 | |
3784 | /* This used to be done _before_ calling x_figure_window_size, but | |
3785 | since the height is reset here, this was really a no-op. I | |
3786 | assume that moving it here does what Gerd intended (although he | |
3787 | no longer can remember what that was... ++KFS, 2003-03-25. */ | |
3788 | ||
3789 | /* Add the tool-bar height to the initial frame height so that the | |
3790 | user gets a text display area of the size he specified with -g or | |
3791 | via .Xdefaults. Later changes of the tool-bar height don't | |
3792 | change the frame size. This is done so that users can create | |
3793 | tall Emacs frames without having to guess how tall the tool-bar | |
3794 | will get. */ | |
3795 | if (toolbar_p && FRAME_TOOL_BAR_LINES (f)) | |
3796 | { | |
3797 | int margin, relief, bar_height; | |
3798 | ||
3799 | relief = (tool_bar_button_relief >= 0 | |
3800 | ? tool_bar_button_relief | |
3801 | : DEFAULT_TOOL_BAR_BUTTON_RELIEF); | |
3802 | ||
3803 | if (INTEGERP (Vtool_bar_button_margin) | |
3804 | && XINT (Vtool_bar_button_margin) > 0) | |
3805 | margin = XFASTINT (Vtool_bar_button_margin); | |
3806 | else if (CONSP (Vtool_bar_button_margin) | |
3807 | && INTEGERP (XCDR (Vtool_bar_button_margin)) | |
3808 | && XINT (XCDR (Vtool_bar_button_margin)) > 0) | |
3809 | margin = XFASTINT (XCDR (Vtool_bar_button_margin)); | |
3810 | else | |
3811 | margin = 0; | |
3812 | ||
3813 | bar_height = DEFAULT_TOOL_BAR_IMAGE_HEIGHT + 2 * margin + 2 * relief; | |
5af5757b | 3814 | FRAME_LINES (f) += (bar_height + FRAME_LINE_HEIGHT (f) - 1) / FRAME_LINE_HEIGHT (f); |
972f4259 KS |
3815 | } |
3816 | ||
3817 | compute_fringe_widths (f, 0); | |
3818 | ||
5af5757b KS |
3819 | FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, FRAME_COLS (f)); |
3820 | FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, FRAME_LINES (f)); | |
972f4259 KS |
3821 | |
3822 | tem0 = x_get_arg (dpyinfo, parms, Qtop, 0, 0, RES_TYPE_NUMBER); | |
3823 | tem1 = x_get_arg (dpyinfo, parms, Qleft, 0, 0, RES_TYPE_NUMBER); | |
3824 | tem2 = x_get_arg (dpyinfo, parms, Quser_position, 0, 0, RES_TYPE_NUMBER); | |
3825 | if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound)) | |
3826 | { | |
3827 | if (EQ (tem0, Qminus)) | |
3828 | { | |
5af5757b | 3829 | f->top_pos = 0; |
972f4259 KS |
3830 | window_prompting |= YNegative; |
3831 | } | |
3832 | else if (CONSP (tem0) && EQ (XCAR (tem0), Qminus) | |
3833 | && CONSP (XCDR (tem0)) | |
3834 | && INTEGERP (XCAR (XCDR (tem0)))) | |
3835 | { | |
5af5757b | 3836 | f->top_pos = - XINT (XCAR (XCDR (tem0))); |
972f4259 KS |
3837 | window_prompting |= YNegative; |
3838 | } | |
3839 | else if (CONSP (tem0) && EQ (XCAR (tem0), Qplus) | |
3840 | && CONSP (XCDR (tem0)) | |
3841 | && INTEGERP (XCAR (XCDR (tem0)))) | |
3842 | { | |
5af5757b | 3843 | f->top_pos = XINT (XCAR (XCDR (tem0))); |
972f4259 KS |
3844 | } |
3845 | else if (EQ (tem0, Qunbound)) | |
5af5757b | 3846 | f->top_pos = 0; |
972f4259 KS |
3847 | else |
3848 | { | |
3849 | CHECK_NUMBER (tem0); | |
5af5757b KS |
3850 | f->top_pos = XINT (tem0); |
3851 | if (f->top_pos < 0) | |
972f4259 KS |
3852 | window_prompting |= YNegative; |
3853 | } | |
3854 | ||
3855 | if (EQ (tem1, Qminus)) | |
3856 | { | |
5af5757b | 3857 | f->left_pos = 0; |
972f4259 KS |
3858 | window_prompting |= XNegative; |
3859 | } | |
3860 | else if (CONSP (tem1) && EQ (XCAR (tem1), Qminus) | |
3861 | && CONSP (XCDR (tem1)) | |
3862 | && INTEGERP (XCAR (XCDR (tem1)))) | |
3863 | { | |
5af5757b | 3864 | f->left_pos = - XINT (XCAR (XCDR (tem1))); |
972f4259 KS |
3865 | window_prompting |= XNegative; |
3866 | } | |
3867 | else if (CONSP (tem1) && EQ (XCAR (tem1), Qplus) | |
3868 | && CONSP (XCDR (tem1)) | |
3869 | && INTEGERP (XCAR (XCDR (tem1)))) | |
3870 | { | |
5af5757b | 3871 | f->left_pos = XINT (XCAR (XCDR (tem1))); |
972f4259 KS |
3872 | } |
3873 | else if (EQ (tem1, Qunbound)) | |
5af5757b | 3874 | f->left_pos = 0; |
972f4259 KS |
3875 | else |
3876 | { | |
3877 | CHECK_NUMBER (tem1); | |
5af5757b KS |
3878 | f->left_pos = XINT (tem1); |
3879 | if (f->left_pos < 0) | |
972f4259 KS |
3880 | window_prompting |= XNegative; |
3881 | } | |
3882 | ||
3883 | if (!NILP (tem2) && ! EQ (tem2, Qunbound)) | |
3884 | window_prompting |= USPosition; | |
3885 | else | |
3886 | window_prompting |= PPosition; | |
3887 | } | |
3888 | ||
5af5757b | 3889 | if (f->want_fullscreen != FULLSCREEN_NONE) |
972f4259 KS |
3890 | { |
3891 | int left, top; | |
3892 | int width, height; | |
3893 | ||
3894 | /* It takes both for some WM:s to place it where we want */ | |
3895 | window_prompting = USPosition | PPosition; | |
3896 | x_fullscreen_adjust (f, &width, &height, &top, &left); | |
5af5757b KS |
3897 | FRAME_COLS (f) = width; |
3898 | FRAME_LINES (f) = height; | |
3899 | FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, width); | |
3900 | FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, height); | |
3901 | f->left_pos = left; | |
3902 | f->top_pos = top; | |
972f4259 KS |
3903 | } |
3904 | ||
3905 | if (window_prompting & XNegative) | |
3906 | { | |
3907 | if (window_prompting & YNegative) | |
5af5757b | 3908 | f->win_gravity = SouthEastGravity; |
972f4259 | 3909 | else |
5af5757b | 3910 | f->win_gravity = NorthEastGravity; |
972f4259 KS |
3911 | } |
3912 | else | |
3913 | { | |
3914 | if (window_prompting & YNegative) | |
5af5757b | 3915 | f->win_gravity = SouthWestGravity; |
972f4259 | 3916 | else |
5af5757b | 3917 | f->win_gravity = NorthWestGravity; |
972f4259 KS |
3918 | } |
3919 | ||
5af5757b | 3920 | f->size_hint_flags = window_prompting; |
972f4259 KS |
3921 | |
3922 | return window_prompting; | |
3923 | } | |
3924 | ||
3925 | ||
3926 | ||
3927 | #endif /* HAVE_WINDOW_SYSTEM */ | |
3928 | ||
3929 | ||
3930 | \f | |
3931 | /*********************************************************************** | |
3932 | Initialization | |
3933 | ***********************************************************************/ | |
3934 | ||
3935 | void | |
3936 | syms_of_frame () | |
3937 | { | |
3938 | Qframep = intern ("framep"); | |
3939 | staticpro (&Qframep); | |
3940 | Qframe_live_p = intern ("frame-live-p"); | |
3941 | staticpro (&Qframe_live_p); | |
3942 | Qheight = intern ("height"); | |
3943 | staticpro (&Qheight); | |
3944 | Qicon = intern ("icon"); | |
3945 | staticpro (&Qicon); | |
3946 | Qminibuffer = intern ("minibuffer"); | |
3947 | staticpro (&Qminibuffer); | |
3948 | Qmodeline = intern ("modeline"); | |
3949 | staticpro (&Qmodeline); | |
3950 | Qonly = intern ("only"); | |
3951 | staticpro (&Qonly); | |
3952 | Qwidth = intern ("width"); | |
3953 | staticpro (&Qwidth); | |
3954 | Qgeometry = intern ("geometry"); | |
3955 | staticpro (&Qgeometry); | |
3956 | Qicon_left = intern ("icon-left"); | |
3957 | staticpro (&Qicon_left); | |
3958 | Qicon_top = intern ("icon-top"); | |
3959 | staticpro (&Qicon_top); | |
3960 | Qleft = intern ("left"); | |
3961 | staticpro (&Qleft); | |
3962 | Qright = intern ("right"); | |
3963 | staticpro (&Qright); | |
3964 | Quser_position = intern ("user-position"); | |
3965 | staticpro (&Quser_position); | |
3966 | Quser_size = intern ("user-size"); | |
3967 | staticpro (&Quser_size); | |
3968 | Qwindow_id = intern ("window-id"); | |
3969 | staticpro (&Qwindow_id); | |
3970 | #ifdef HAVE_X_WINDOWS | |
3971 | Qouter_window_id = intern ("outer-window-id"); | |
3972 | staticpro (&Qouter_window_id); | |
3973 | #endif | |
3974 | Qparent_id = intern ("parent-id"); | |
3975 | staticpro (&Qparent_id); | |
3976 | Qx = intern ("x"); | |
3977 | staticpro (&Qx); | |
3978 | Qw32 = intern ("w32"); | |
3979 | staticpro (&Qw32); | |
3980 | Qpc = intern ("pc"); | |
3981 | staticpro (&Qpc); | |
3982 | Qmac = intern ("mac"); | |
3983 | staticpro (&Qmac); | |
3984 | Qvisible = intern ("visible"); | |
3985 | staticpro (&Qvisible); | |
3986 | Qbuffer_predicate = intern ("buffer-predicate"); | |
3987 | staticpro (&Qbuffer_predicate); | |
3988 | Qbuffer_list = intern ("buffer-list"); | |
3989 | staticpro (&Qbuffer_list); | |
3990 | Qdisplay_type = intern ("display-type"); | |
3991 | staticpro (&Qdisplay_type); | |
3992 | Qbackground_mode = intern ("background-mode"); | |
3993 | staticpro (&Qbackground_mode); | |
3994 | Qtty_color_mode = intern ("tty-color-mode"); | |
3995 | staticpro (&Qtty_color_mode); | |
3996 | ||
3997 | Qface_set_after_frame_default = intern ("face-set-after-frame-default"); | |
3998 | staticpro (&Qface_set_after_frame_default); | |
3999 | ||
4000 | Qfullwidth = intern ("fullwidth"); | |
4001 | staticpro (&Qfullwidth); | |
4002 | Qfullheight = intern ("fullheight"); | |
4003 | staticpro (&Qfullheight); | |
4004 | Qfullboth = intern ("fullboth"); | |
4005 | staticpro (&Qfullboth); | |
4006 | Qx_resource_name = intern ("x-resource-name"); | |
4007 | staticpro (&Qx_resource_name); | |
4008 | ||
4009 | Qx_frame_parameter = intern ("x-frame-parameter"); | |
4010 | staticpro (&Qx_frame_parameter); | |
4011 | ||
4012 | { | |
4013 | int i; | |
4014 | ||
4015 | for (i = 0; i < sizeof (frame_parms) / sizeof (frame_parms[0]); i++) | |
4016 | { | |
4017 | Lisp_Object v = intern (frame_parms[i].name); | |
4018 | if (frame_parms[i].variable) | |
4019 | { | |
4020 | *frame_parms[i].variable = v; | |
4021 | staticpro (frame_parms[i].variable); | |
4022 | } | |
4023 | Fput (v, Qx_frame_parameter, make_number (i)); | |
4024 | } | |
4025 | } | |
4026 | ||
2731a0ad | 4027 | #ifdef HAVE_WINDOW_SYSTEM |
972f4259 KS |
4028 | DEFVAR_LISP ("x-resource-name", &Vx_resource_name, |
4029 | doc: /* The name Emacs uses to look up X resources. | |
4030 | `x-get-resource' uses this as the first component of the instance name | |
4031 | when requesting resource values. | |
4032 | Emacs initially sets `x-resource-name' to the name under which Emacs | |
4033 | was invoked, or to the value specified with the `-name' or `-rn' | |
4034 | switches, if present. | |
4035 | ||
4036 | It may be useful to bind this variable locally around a call | |
4037 | to `x-get-resource'. See also the variable `x-resource-class'. */); | |
4038 | Vx_resource_name = Qnil; | |
4039 | ||
4040 | DEFVAR_LISP ("x-resource-class", &Vx_resource_class, | |
4041 | doc: /* The class Emacs uses to look up X resources. | |
4042 | `x-get-resource' uses this as the first component of the instance class | |
4043 | when requesting resource values. | |
4044 | ||
4045 | Emacs initially sets `x-resource-class' to "Emacs". | |
4046 | ||
4047 | Setting this variable permanently is not a reasonable thing to do, | |
4048 | but binding this variable locally around a call to `x-get-resource' | |
4049 | is a reasonable practice. See also the variable `x-resource-name'. */); | |
4050 | Vx_resource_class = build_string (EMACS_CLASS); | |
2731a0ad | 4051 | #endif |
972f4259 KS |
4052 | |
4053 | DEFVAR_LISP ("default-frame-alist", &Vdefault_frame_alist, | |
4054 | doc: /* Alist of default values for frame creation. | |
4055 | These may be set in your init file, like this: | |
5ff00c42 | 4056 | (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1))) |
972f4259 KS |
4057 | These override values given in window system configuration data, |
4058 | including X Windows' defaults database. | |
4059 | For values specific to the first Emacs frame, see `initial-frame-alist'. | |
4060 | For values specific to the separate minibuffer frame, see | |
4061 | `minibuffer-frame-alist'. | |
4062 | The `menu-bar-lines' element of the list controls whether new frames | |
4063 | have menu bars; `menu-bar-mode' works by altering this element. | |
4064 | Setting this variable does not affect existing frames, only new ones. */); | |
4065 | Vdefault_frame_alist = Qnil; | |
4066 | ||
a6e20602 KS |
4067 | DEFVAR_LISP ("default-frame-scroll-bars", &Vdefault_frame_scroll_bars, |
4068 | doc: /* Default position of scroll bars on this window-system. */); | |
4069 | #ifdef HAVE_WINDOW_SYSTEM | |
b15325b2 | 4070 | #if defined(HAVE_NTGUI) || defined(MAC_OS) |
a6e20602 KS |
4071 | /* MS-Windows has scroll bars on the right by default. */ |
4072 | Vdefault_frame_scroll_bars = Qright; | |
4073 | #else | |
4074 | Vdefault_frame_scroll_bars = Qleft; | |
4075 | #endif | |
4076 | #else | |
4077 | Vdefault_frame_scroll_bars = Qnil; | |
4078 | #endif | |
4079 | ||
972f4259 KS |
4080 | Qinhibit_default_face_x_resources |
4081 | = intern ("inhibit-default-face-x-resources"); | |
4082 | staticpro (&Qinhibit_default_face_x_resources); | |
4083 | ||
4084 | DEFVAR_LISP ("terminal-frame", &Vterminal_frame, | |
4085 | doc: /* The initial frame-object, which represents Emacs's stdout. */); | |
4086 | ||
4087 | DEFVAR_LISP ("emacs-iconified", &Vemacs_iconified, | |
4088 | doc: /* Non-nil if all of emacs is iconified and frame updates are not needed. */); | |
4089 | Vemacs_iconified = Qnil; | |
4090 | ||
4091 | DEFVAR_LISP ("mouse-position-function", &Vmouse_position_function, | |
4092 | doc: /* If non-nil, function to transform normal value of `mouse-position'. | |
4093 | `mouse-position' calls this function, passing its usual return value as | |
4094 | argument, and returns whatever this function returns. | |
4095 | This abnormal hook exists for the benefit of packages like `xt-mouse.el' | |
4096 | which need to do mouse handling at the Lisp level. */); | |
4097 | Vmouse_position_function = Qnil; | |
4098 | ||
4099 | DEFVAR_LISP ("mouse-highlight", &Vmouse_highlight, | |
4100 | doc: /* If non-nil, clickable text is highlighted when mouse is over it. | |
4101 | If the value is an integer, highlighting is only shown after moving the | |
4102 | mouse, while keyboard input turns off the highlight even when the mouse | |
4103 | is over the clickable text. However, the mouse shape still indicates | |
4104 | when the mouse is over clickable text. */); | |
4105 | Vmouse_highlight = Qt; | |
4106 | ||
4107 | DEFVAR_LISP ("delete-frame-functions", &Vdelete_frame_functions, | |
4108 | doc: /* Functions to be run before deleting a frame. | |
4109 | The functions are run with one arg, the frame to be deleted. | |
4110 | See `delete-frame'. */); | |
4111 | Vdelete_frame_functions = Qnil; | |
4112 | ||
4113 | DEFVAR_KBOARD ("default-minibuffer-frame", Vdefault_minibuffer_frame, | |
4114 | doc: /* Minibufferless frames use this frame's minibuffer. | |
4115 | ||
4116 | Emacs cannot create minibufferless frames unless this is set to an | |
4117 | appropriate surrogate. | |
4118 | ||
4119 | Emacs consults this variable only when creating minibufferless | |
4120 | frames; once the frame is created, it sticks with its assigned | |
4121 | minibuffer, no matter what this variable is set to. This means that | |
4122 | this variable doesn't necessarily say anything meaningful about the | |
4123 | current set of frames, or where the minibuffer is currently being | |
4124 | displayed. | |
4125 | ||
4126 | This variable is local to the current terminal and cannot be buffer-local. */); | |
4127 | ||
4128 | staticpro (&Vframe_list); | |
4129 | ||
4130 | defsubr (&Sactive_minibuffer_window); | |
4131 | defsubr (&Sframep); | |
4132 | defsubr (&Sframe_live_p); | |
4133 | defsubr (&Smake_terminal_frame); | |
4134 | defsubr (&Shandle_switch_frame); | |
972f4259 KS |
4135 | defsubr (&Sselect_frame); |
4136 | defsubr (&Sselected_frame); | |
4137 | defsubr (&Swindow_frame); | |
4138 | defsubr (&Sframe_root_window); | |
4139 | defsubr (&Sframe_first_window); | |
4140 | defsubr (&Sframe_selected_window); | |
4141 | defsubr (&Sset_frame_selected_window); | |
4142 | defsubr (&Sframe_list); | |
4143 | defsubr (&Snext_frame); | |
4144 | defsubr (&Sprevious_frame); | |
4145 | defsubr (&Sdelete_frame); | |
4146 | defsubr (&Smouse_position); | |
4147 | defsubr (&Smouse_pixel_position); | |
4148 | defsubr (&Sset_mouse_position); | |
4149 | defsubr (&Sset_mouse_pixel_position); | |
4150 | #if 0 | |
4151 | defsubr (&Sframe_configuration); | |
4152 | defsubr (&Srestore_frame_configuration); | |
4153 | #endif | |
4154 | defsubr (&Smake_frame_visible); | |
4155 | defsubr (&Smake_frame_invisible); | |
4156 | defsubr (&Siconify_frame); | |
4157 | defsubr (&Sframe_visible_p); | |
4158 | defsubr (&Svisible_frame_list); | |
4159 | defsubr (&Sraise_frame); | |
4160 | defsubr (&Slower_frame); | |
4161 | defsubr (&Sredirect_frame_focus); | |
4162 | defsubr (&Sframe_focus); | |
4163 | defsubr (&Sframe_parameters); | |
4164 | defsubr (&Sframe_parameter); | |
4165 | defsubr (&Smodify_frame_parameters); | |
4166 | defsubr (&Sframe_char_height); | |
4167 | defsubr (&Sframe_char_width); | |
4168 | defsubr (&Sframe_pixel_height); | |
4169 | defsubr (&Sframe_pixel_width); | |
4170 | defsubr (&Sset_frame_height); | |
4171 | defsubr (&Sset_frame_width); | |
4172 | defsubr (&Sset_frame_size); | |
4173 | defsubr (&Sset_frame_position); | |
4174 | ||
4175 | #ifdef HAVE_WINDOW_SYSTEM | |
4176 | defsubr (&Sx_get_resource); | |
4177 | defsubr (&Sx_parse_geometry); | |
4178 | #endif | |
4179 | ||
dc6f92b8 | 4180 | } |
ab5796a9 MB |
4181 | |
4182 | /* arch-tag: 7dbf2c69-9aad-45f8-8296-db893d6dd039 | |
4183 | (do not change this comment) */ |