|
428
|
1 ;;; frame.el --- multi-frame management independent of window systems.
|
|
|
2
|
|
1942
|
3 ;; Copyright (C) 1993, 1994, 1996, 1997, 2000, 2001, 2003
|
|
|
4 ;; Free Software Foundation, Inc.
|
|
428
|
5 ;; Copyright (C) 1995, 1996 Ben Wing.
|
|
|
6
|
|
|
7 ;; Maintainer: XEmacs Development Team
|
|
|
8 ;; Keywords: internal, dumped
|
|
|
9
|
|
|
10 ;; This file is part of XEmacs.
|
|
|
11
|
|
|
12 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
13 ;; under the terms of the GNU General Public License as published by
|
|
|
14 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
15 ;; any later version.
|
|
|
16
|
|
|
17 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
20 ;; General Public License for more details.
|
|
|
21
|
|
|
22 ;; You should have received a copy of the GNU General Public License
|
|
|
23 ;; along with XEmacs; see the file COPYING. If not, write to the
|
|
1942
|
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
428
|
25 ;; Boston, MA 02111-1307, USA.
|
|
|
26
|
|
1942
|
27 ;;; Synched up with: FSF 21.3.
|
|
428
|
28
|
|
|
29 ;;; Commentary:
|
|
|
30
|
|
|
31 ;; This file is dumped with XEmacs.
|
|
|
32
|
|
|
33 ;;; Code:
|
|
|
34
|
|
1942
|
35 ;; XEmacs addition
|
|
428
|
36 (defgroup frames nil
|
|
|
37 "Support for Emacs frames and window systems."
|
|
|
38 :group 'environment)
|
|
|
39
|
|
1942
|
40 ;; XEmacs change: No need for `frame-creation-function'.
|
|
428
|
41
|
|
1942
|
42 ;; XEmacs change: Emacs no longer specifies the minibuffer property here.
|
|
428
|
43 ;;; The initial value given here for this must ask for a minibuffer.
|
|
|
44 ;;; There must always exist a frame with a minibuffer, and after we
|
|
|
45 ;;; delete the terminal frame, this will be the only frame.
|
|
|
46 (defcustom initial-frame-plist '(minibuffer t)
|
|
|
47 "Plist of frame properties for creating the initial X window frame.
|
|
|
48 You can set this in your `.emacs' file; for example,
|
|
|
49 (setq initial-frame-plist '(top 1 left 1 width 80 height 55))
|
|
|
50 Properties specified here supersede the values given in `default-frame-plist'.
|
|
|
51 The format of this can also be an alist for backward compatibility.
|
|
|
52
|
|
|
53 If the value calls for a frame without a minibuffer, and you have not created
|
|
|
54 a minibuffer frame on your own, one is created according to
|
|
|
55 `minibuffer-frame-plist'.
|
|
|
56
|
|
|
57 You can specify geometry-related options for just the initial frame
|
|
|
58 by setting this variable in your `.emacs' file; however, they won't
|
|
|
59 take effect until Emacs reads `.emacs', which happens after first creating
|
|
|
60 the frame. If you want the frame to have the proper geometry as soon
|
|
|
61 as it appears, you need to use this three-step process:
|
|
|
62 * Specify X resources to give the geometry you want.
|
|
|
63 * Set `default-frame-plist' to override these options so that they
|
|
|
64 don't affect subsequent frames.
|
|
|
65 * Set `initial-frame-plist' in a way that matches the X resources,
|
|
|
66 to override what you put in `default-frame-plist'."
|
|
|
67 :type 'plist
|
|
|
68 :group 'frames)
|
|
|
69
|
|
|
70 (defcustom minibuffer-frame-plist '(width 80 height 2 menubar-visible-p nil
|
|
1942
|
71 default-toolbar-visible-p nil)
|
|
428
|
72 "Plist of frame properties for initially creating a minibuffer frame.
|
|
|
73 You can set this in your `.emacs' file; for example,
|
|
|
74 (setq minibuffer-frame-plist '(top 1 left 1 width 80 height 2))
|
|
|
75 Properties specified here supersede the values given in
|
|
|
76 `default-frame-plist'.
|
|
|
77 The format of this can also be an alist for backward compatibility."
|
|
|
78 :type 'plist
|
|
|
79 :group 'frames)
|
|
|
80
|
|
|
81 (defcustom pop-up-frame-plist nil
|
|
|
82 "Plist of frame properties used when creating pop-up frames.
|
|
|
83 Pop-up frames are used for completions, help, and the like.
|
|
|
84 This variable can be set in your init file, like this:
|
|
|
85 (setq pop-up-frame-plist '(width 80 height 20))
|
|
1942
|
86 These supersede the values given in `default-frame-plist', for pop-up frames.
|
|
428
|
87 The format of this can also be an alist for backward compatibility."
|
|
|
88 :type 'plist
|
|
|
89 :group 'frames)
|
|
|
90
|
|
|
91 (setq pop-up-frame-function
|
|
1942
|
92 #'(lambda ()
|
|
|
93 (make-frame pop-up-frame-plist)))
|
|
428
|
94
|
|
|
95 (defcustom special-display-frame-plist '(height 14 width 80 unsplittable t)
|
|
|
96 "*Plist of frame properties used when creating special frames.
|
|
|
97 Special frames are used for buffers whose names are in
|
|
|
98 `special-display-buffer-names' and for buffers whose names match
|
|
|
99 one of the regular expressions in `special-display-regexps'.
|
|
|
100 This variable can be set in your init file, like this:
|
|
|
101 (setq special-display-frame-plist '(width 80 height 20))
|
|
|
102 These supersede the values given in `default-frame-plist'.
|
|
|
103 The format of this can also be an alist for backward compatibility."
|
|
|
104 :type 'plist
|
|
|
105 :group 'frames)
|
|
|
106
|
|
1942
|
107 ;; XEmacs addition
|
|
428
|
108 (defun safe-alist-to-plist (cruftiness)
|
|
|
109 (if (consp (car cruftiness))
|
|
|
110 (alist-to-plist cruftiness)
|
|
|
111 cruftiness))
|
|
|
112
|
|
1942
|
113 ;; XEmacs change: require args to be a plist instead of an alist.
|
|
428
|
114 (defun special-display-popup-frame (buffer &optional args)
|
|
1942
|
115 "Display BUFFER in its own frame, reusing an existing window if any.
|
|
|
116 Return the window chosen.
|
|
|
117 Currently we do not insist on selecting the window within its frame.
|
|
|
118 If ARGS is a plist, use it as a list of frame property specs.
|
|
|
119 If ARGS is a list whose car is t,
|
|
|
120 use (cadr ARGS) as a function to do the work.
|
|
|
121 Pass it BUFFER as first arg, and (cddr ARGS) gives the rest of the args."
|
|
428
|
122 ;; if we can't display simultaneous multiple frames, just return
|
|
|
123 ;; nil and let the normal behavior take over.
|
|
|
124 (and (device-on-window-system-p)
|
|
|
125 (if (and args (eq t (car args)))
|
|
|
126 (apply (cadr args) buffer (cddr args))
|
|
|
127 (let ((window (get-buffer-window buffer t)))
|
|
1942
|
128 (setq args (safe-alist-to-plist args))
|
|
|
129 (or
|
|
|
130 ;; If we have a window already, make it visible.
|
|
|
131 (when window
|
|
|
132 (let ((frame (window-frame window)))
|
|
|
133 (make-frame-visible frame)
|
|
|
134 (raise-frame frame)
|
|
|
135 window))
|
|
|
136 ;; Reuse the current window if the user requested it.
|
|
|
137 (when (lax-plist-get args 'same-window)
|
|
|
138 (condition-case nil
|
|
|
139 (progn (switch-to-buffer buffer) (selected-window))
|
|
|
140 (error nil)))
|
|
|
141 ;; Stay on the same frame if requested.
|
|
|
142 (when (or (lax-plist-get args 'same-frame)
|
|
|
143 (lax-plist-get args 'same-window))
|
|
|
144 (let* ((pop-up-frames nil) (pop-up-windows t)
|
|
|
145 special-display-regexps special-display-buffer-names
|
|
|
146 (window (display-buffer buffer)))
|
|
|
147 ;; (set-window-dedicated-p window t)
|
|
|
148 window))
|
|
|
149 ;; If no window yet, make one in a new frame.
|
|
|
150 (let ((frame (make-frame (append args
|
|
|
151 (safe-alist-to-plist
|
|
|
152 special-display-frame-plist)))))
|
|
|
153 (set-window-buffer (frame-selected-window frame) buffer)
|
|
|
154 (set-window-dedicated-p (frame-selected-window frame) t)
|
|
|
155 (frame-selected-window frame)))))))
|
|
428
|
156
|
|
1942
|
157 ;; XEmacs change: comment out
|
|
428
|
158 ;(defun handle-delete-frame (event)
|
|
1942
|
159 ; "Handle delete-frame events from the X server."
|
|
428
|
160 ; (interactive "e")
|
|
|
161 ; (let ((frame (posn-window (event-start event)))
|
|
|
162 ; (i 0)
|
|
|
163 ; (tail (frame-list)))
|
|
|
164 ; (while tail
|
|
|
165 ; (and (frame-visible-p (car tail))
|
|
|
166 ; (not (eq (car tail) frame))
|
|
|
167 ; (setq i (1+ i)))
|
|
|
168 ; (setq tail (cdr tail)))
|
|
|
169 ; (if (> i 0)
|
|
|
170 ; (delete-frame frame t)
|
|
1942
|
171 ; ;; Gildea@x.org says it is ok to ask questions before terminating.
|
|
|
172 ; (save-buffers-kill-emacs))))
|
|
428
|
173
|
|
|
174 ;;;; Arrangement of frames at startup
|
|
|
175
|
|
1942
|
176 ;; 1) Load the window system startup file from the lisp library and read the
|
|
|
177 ;; high-priority arguments (-q and the like). The window system startup
|
|
|
178 ;; file should create any frames specified in the window system defaults.
|
|
|
179 ;;
|
|
|
180 ;; 2) If no frames have been opened, we open an initial text frame.
|
|
|
181 ;;
|
|
|
182 ;; 3) Once the init file is done, we apply any newly set properties
|
|
|
183 ;; in initial-frame-plist to the frame.
|
|
428
|
184
|
|
1942
|
185 ;; These are now called explicitly at the proper times,
|
|
|
186 ;; since that is easier to understand.
|
|
|
187 ;; Actually using hooks within Emacs is bad for future maintenance. --rms.
|
|
|
188 ;; (add-hook 'before-init-hook 'frame-initialize)
|
|
|
189 ;; (add-hook 'window-setup-hook 'frame-notice-user-settings)
|
|
|
190
|
|
|
191 ;; If we create the initial frame, this is it.
|
|
428
|
192 (defvar frame-initial-frame nil)
|
|
|
193
|
|
|
194 ;; Record the properties used in frame-initialize to make the initial frame.
|
|
|
195 (defvar frame-initial-frame-plist)
|
|
|
196
|
|
|
197 (defvar frame-initial-geometry-arguments nil)
|
|
|
198
|
|
1942
|
199 ;; XEmacs addition
|
|
428
|
200 (defun canonicalize-frame-plists ()
|
|
|
201 (setq initial-frame-plist (safe-alist-to-plist initial-frame-plist))
|
|
|
202 (setq default-frame-plist (safe-alist-to-plist default-frame-plist)))
|
|
|
203
|
|
1942
|
204 ;; startup.el calls this function before loading the user's init
|
|
|
205 ;; file - if there is no frame with a minibuffer open now, create
|
|
|
206 ;; one to display messages while loading the init file.
|
|
428
|
207 (defun frame-initialize ()
|
|
1942
|
208 "Create an initial frame if necessary."
|
|
428
|
209 ;; In batch mode, we actually use the initial terminal device for output.
|
|
1942
|
210 ;; XEmacs addition
|
|
428
|
211 (canonicalize-frame-plists)
|
|
1942
|
212
|
|
428
|
213 (if (not (noninteractive))
|
|
|
214 (progn
|
|
1942
|
215 ;; Turn on special-display processing only if there's a window system.
|
|
|
216 (setq special-display-function 'special-display-popup-frame)
|
|
428
|
217
|
|
|
218 ;; If there is no frame with a minibuffer besides the terminal
|
|
|
219 ;; frame, then we need to create the opening frame. Make sure
|
|
|
220 ;; it has a minibuffer, but let initial-frame-plist omit the
|
|
|
221 ;; minibuffer spec.
|
|
|
222 (or (delq terminal-frame (minibuffer-frame-list))
|
|
|
223 (progn
|
|
|
224 (setq frame-initial-frame-plist
|
|
|
225 (append initial-frame-plist default-frame-plist))
|
|
1942
|
226 ;; XEmacs change: omit the scrollbar settings
|
|
|
227 ; (or (assq 'horizontal-scroll-bars frame-initial-frame-alist)
|
|
|
228 ; (setq frame-initial-frame-alist
|
|
|
229 ; (cons '(horizontal-scroll-bars . t)
|
|
|
230 ; frame-initial-frame-alist)))
|
|
428
|
231 (setq default-minibuffer-frame
|
|
|
232 (setq frame-initial-frame
|
|
|
233 (make-frame initial-frame-plist
|
|
|
234 (car (delq terminal-device
|
|
|
235 (device-list))))))
|
|
|
236 ;; Delete any specifications for window geometry properties
|
|
|
237 ;; so that we won't reapply them in frame-notice-user-settings.
|
|
|
238 ;; It would be wrong to reapply them then,
|
|
|
239 ;; because that would override explicit user resizing.
|
|
|
240 (setq initial-frame-plist
|
|
|
241 (frame-remove-geometry-props initial-frame-plist))))
|
|
|
242 ;; At this point, we know that we have a frame open, so we
|
|
1942
|
243 ;; can delete the terminal frame.
|
|
|
244 ;; XEmacs change: Do it the same way Fkill_emacs does it. -slb
|
|
428
|
245 (delete-console terminal-console)
|
|
1942
|
246 (setq terminal-frame nil))
|
|
428
|
247
|
|
1942
|
248 ;; XEmacs change: omit the pc window-system stuff.
|
|
|
249 ; ;; No, we're not running a window system. Use make-terminal-frame if
|
|
|
250 ; ;; we support that feature, otherwise arrange to cause errors.
|
|
|
251 ; (or (eq window-system 'pc)
|
|
|
252 ; (setq frame-creation-function
|
|
|
253 ; (if (fboundp 'tty-create-frame-with-faces)
|
|
|
254 ; 'tty-create-frame-with-faces
|
|
|
255 ; (function
|
|
|
256 ; (lambda (parameters)
|
|
|
257 ; (error
|
|
|
258 ; "Can't create multiple frames without a window system"))))))
|
|
|
259 ))
|
|
|
260
|
|
|
261 (defvar frame-notice-user-settings t
|
|
|
262 "Non-nil means function `frame-notice-user-settings' wasn't run yet.")
|
|
428
|
263
|
|
1942
|
264 ;; startup.el calls this function after loading the user's init
|
|
|
265 ;; file. Now default-frame-plist and initial-frame-plist contain
|
|
|
266 ;; information to which we must react; do what needs to be done.
|
|
428
|
267 (defun frame-notice-user-settings ()
|
|
1942
|
268 "Act on user's init file settings of frame parameters.
|
|
|
269 React to settings of `default-frame-plist', `initial-frame-plist' there."
|
|
|
270 ;; XEmacs addition
|
|
|
271 (canonicalize-frame-plists)
|
|
428
|
272
|
|
1942
|
273 ;; XEmacs change: omit menu-bar manipulations.
|
|
|
274 ; ;; Make menu-bar-mode and default-frame-alist consistent.
|
|
|
275 ; (when (boundp 'menu-bar-mode)
|
|
|
276 ; (let ((default (assq 'menu-bar-lines default-frame-alist)))
|
|
|
277 ; (if default
|
|
|
278 ; (setq menu-bar-mode (not (eq (cdr default) 0)))
|
|
|
279 ; (setq default-frame-alist
|
|
|
280 ; (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
|
|
|
281 ; default-frame-alist)))))
|
|
428
|
282
|
|
1942
|
283 ;; XEmacs change: omit tool-bar manipulations.
|
|
|
284 ; ;; Make tool-bar-mode and default-frame-alist consistent. Don't do
|
|
|
285 ; ;; it in batch mode since that would leave a tool-bar-lines
|
|
|
286 ; ;; parameter in default-frame-alist in a dumped Emacs, which is not
|
|
|
287 ; ;; what we want.
|
|
|
288 ; (when (and (boundp 'tool-bar-mode)
|
|
|
289 ; (not noninteractive))
|
|
|
290 ; (let ((default (assq 'tool-bar-lines default-frame-alist)))
|
|
|
291 ; (if default
|
|
|
292 ; (setq tool-bar-mode (not (eq (cdr default) 0)))
|
|
|
293 ; (setq default-frame-alist
|
|
|
294 ; (cons (cons 'tool-bar-lines (if tool-bar-mode 1 0))
|
|
|
295 ; default-frame-alist)))))
|
|
428
|
296
|
|
|
297 ;; Creating and deleting frames may shift the selected frame around,
|
|
|
298 ;; and thus the current buffer. Protect against that. We don't
|
|
|
299 ;; want to use save-excursion here, because that may also try to set
|
|
|
300 ;; the buffer of the selected window, which fails when the selected
|
|
|
301 ;; window is the minibuffer.
|
|
|
302 (let ((old-buffer (current-buffer)))
|
|
|
303
|
|
1942
|
304 ;; XEmacs change: omit special handling for MS-DOS
|
|
|
305 ; (when (and frame-notice-user-settings
|
|
|
306 ; (null frame-initial-frame))
|
|
|
307 ; ;; This case happens when we don't have a window system, and
|
|
|
308 ; ;; also for MS-DOS frames.
|
|
|
309 ; (let ((parms (frame-parameters frame-initial-frame)))
|
|
|
310 ; ;; Don't change the frame names.
|
|
|
311 ; (setq parms (delq (assq 'name parms) parms))
|
|
|
312 ; ;; Can't modify the minibuffer parameter, so don't try.
|
|
|
313 ; (setq parms (delq (assq 'minibuffer parms) parms))
|
|
|
314 ; (modify-frame-parameters nil
|
|
|
315 ; (if (null window-system)
|
|
|
316 ; (append initial-frame-alist
|
|
|
317 ; default-frame-alist
|
|
|
318 ; parms
|
|
|
319 ; nil)
|
|
|
320 ; ;; initial-frame-alist and
|
|
|
321 ; ;; default-frame-alist were already
|
|
|
322 ; ;; applied in pc-win.el.
|
|
|
323 ; parms))
|
|
|
324 ; (if (null window-system) ;; MS-DOS does this differently in pc-win.el
|
|
|
325 ; (let ((newparms (frame-parameters))
|
|
|
326 ; (frame (selected-frame)))
|
|
|
327 ; (tty-handle-reverse-video frame newparms)
|
|
|
328 ; ;; If we changed the background color, we need to update
|
|
|
329 ; ;; the background-mode parameter, and maybe some faces,
|
|
|
330 ; ;; too.
|
|
|
331 ; (when (assq 'background-color newparms)
|
|
|
332 ; (unless (or (assq 'background-mode initial-frame-alist)
|
|
|
333 ; (assq 'background-mode default-frame-alist))
|
|
|
334 ; (frame-set-background-mode frame))
|
|
|
335 ; (face-set-after-frame-default frame))))))
|
|
|
336
|
|
428
|
337 ;; If the initial frame is still around, apply initial-frame-plist
|
|
|
338 ;; and default-frame-plist to it.
|
|
1942
|
339 (when (frame-live-p frame-initial-frame)
|
|
|
340
|
|
|
341 ;; XEmacs change: omit the tool-bar manipulations
|
|
|
342 ; ;; When tool-bar has been switched off, correct the frame size
|
|
|
343 ; ;; by the lines added in x-create-frame for the tool-bar and
|
|
|
344 ; ;; switch `tool-bar-mode' off.
|
|
|
345 ; (when (display-graphic-p)
|
|
|
346 ; (let ((tool-bar-lines (or (assq 'tool-bar-lines initial-frame-alist)
|
|
|
347 ; (assq 'tool-bar-lines default-frame-alist))))
|
|
|
348 ; (when (and tool-bar-originally-present
|
|
|
349 ; (or (null tool-bar-lines)
|
|
|
350 ; (null (cdr tool-bar-lines))
|
|
|
351 ; (eq 0 (cdr tool-bar-lines))))
|
|
|
352 ; (let* ((char-height (frame-char-height frame-initial-frame))
|
|
|
353 ; (image-height tool-bar-images-pixel-height)
|
|
|
354 ; (margin (cond ((and (consp tool-bar-button-margin)
|
|
|
355 ; (integerp (cdr tool-bar-button-margin))
|
|
|
356 ; (> tool-bar-button-margin 0))
|
|
|
357 ; (cdr tool-bar-button-margin))
|
|
|
358 ; ((and (integerp tool-bar-button-margin)
|
|
|
359 ; (> tool-bar-button-margin 0))
|
|
|
360 ; tool-bar-button-margin)
|
|
|
361 ; (t 0)))
|
|
|
362 ; (relief (if (and (integerp tool-bar-button-relief)
|
|
|
363 ; (> tool-bar-button-relief 0))
|
|
|
364 ; tool-bar-button-relief 3))
|
|
|
365 ; (lines (/ (+ image-height
|
|
|
366 ; (* 2 margin)
|
|
|
367 ; (* 2 relief)
|
|
|
368 ; (1- char-height))
|
|
|
369 ; char-height))
|
|
|
370 ; (height (frame-parameter frame-initial-frame 'height))
|
|
|
371 ; (newparms (list (cons 'height (- height lines))))
|
|
|
372 ; (initial-top (cdr (assq 'top
|
|
|
373 ; frame-initial-geometry-arguments)))
|
|
|
374 ; (top (frame-parameter frame-initial-frame 'top)))
|
|
|
375 ; (when (and (consp initial-top) (eq '- (car initial-top)))
|
|
|
376 ; (let ((adjusted-top
|
|
|
377 ; (cond ((and (consp top)
|
|
|
378 ; (eq '+ (car top)))
|
|
|
379 ; (list '+
|
|
|
380 ; (+ (cadr top)
|
|
|
381 ; (* lines char-height))))
|
|
|
382 ; ((and (consp top)
|
|
|
383 ; (eq '- (car top)))
|
|
|
384 ; (list '-
|
|
|
385 ; (- (cadr top)
|
|
|
386 ; (* lines char-height))))
|
|
|
387 ; (t (+ top (* lines char-height))))))
|
|
|
388 ; (setq newparms
|
|
|
389 ; (append newparms
|
|
|
390 ; `((top . ,adjusted-top))
|
|
|
391 ; nil))))
|
|
|
392 ; (modify-frame-parameters frame-initial-frame newparms)
|
|
|
393 ; (tool-bar-mode -1)))))
|
|
428
|
394
|
|
|
395 ;; The initial frame we create above always has a minibuffer.
|
|
|
396 ;; If the user wants to remove it, or make it a minibuffer-only
|
|
|
397 ;; frame, then we'll have to delete the selected frame and make a
|
|
|
398 ;; new one; you can't remove or add a root window to/from an
|
|
|
399 ;; existing frame.
|
|
|
400 ;;
|
|
|
401 ;; NOTE: default-frame-plist was nil when we created the
|
|
|
402 ;; existing frame. We need to explicitly include
|
|
|
403 ;; default-frame-plist in the properties of the screen we
|
|
|
404 ;; create here, so that its new value, gleaned from the user's
|
|
|
405 ;; .emacs file, will be applied to the existing screen.
|
|
|
406 (if (not (eq (car
|
|
|
407 (or (and (lax-plist-member
|
|
|
408 initial-frame-plist 'minibuffer)
|
|
|
409 (list (lax-plist-get initial-frame-plist
|
|
|
410 'minibuffer)))
|
|
|
411 (and (lax-plist-member default-frame-plist
|
|
|
412 'minibuffer)
|
|
|
413 (list (lax-plist-get default-frame-plist
|
|
|
414 'minibuffer)))
|
|
|
415 '(t)))
|
|
|
416 t))
|
|
|
417 ;; Create the new frame.
|
|
2367
|
418 (let (props ;new
|
|
|
419 )
|
|
428
|
420 ;; If the frame isn't visible yet, wait till it is.
|
|
|
421 ;; If the user has to position the window,
|
|
|
422 ;; Emacs doesn't know its real position until
|
|
|
423 ;; the frame is seen to be visible.
|
|
|
424
|
|
1942
|
425 ;; XEmacs change: check the initially-unmapped property
|
|
428
|
426 (if (frame-property frame-initial-frame 'initially-unmapped)
|
|
|
427 nil
|
|
|
428 (while (not (frame-visible-p frame-initial-frame))
|
|
|
429 (sleep-for 1)))
|
|
|
430 (setq props (frame-properties frame-initial-frame))
|
|
1942
|
431
|
|
428
|
432 ;; Get rid of `name' unless it was specified explicitly before.
|
|
|
433 (or (lax-plist-member frame-initial-frame-plist 'name)
|
|
|
434 (setq props (lax-plist-remprop props 'name)))
|
|
1942
|
435
|
|
|
436 (setq props (append initial-frame-plist
|
|
|
437 default-frame-plist
|
|
428
|
438 props
|
|
|
439 nil))
|
|
1942
|
440
|
|
428
|
441 ;; Get rid of `reverse', because that was handled
|
|
|
442 ;; when we first made the frame.
|
|
|
443 (laxputf props 'reverse nil)
|
|
1942
|
444
|
|
|
445 ;; XEmacs addition: Get rid of `window-id', otherwise make-frame
|
|
|
446 ;; will think we're trying to setup an external widget.
|
|
428
|
447 (laxremf props 'window-id)
|
|
1942
|
448
|
|
428
|
449 (if (lax-plist-member frame-initial-geometry-arguments 'height)
|
|
|
450 (laxremf props 'height))
|
|
|
451 (if (lax-plist-member frame-initial-geometry-arguments 'width)
|
|
|
452 (laxremf props 'width))
|
|
|
453 (if (lax-plist-member frame-initial-geometry-arguments 'left)
|
|
|
454 (laxremf props 'left))
|
|
|
455 (if (lax-plist-member frame-initial-geometry-arguments 'top)
|
|
|
456 (laxremf props 'top))
|
|
|
457 ;; Now create the replacement initial frame.
|
|
2367
|
458 ;(setq new
|
|
|
459 (make-frame
|
|
|
460 ;; Use the geometry args that created the existing
|
|
|
461 ;; frame, rather than the props we get for it.
|
|
|
462 (append '(user-size t user-position t)
|
|
|
463 frame-initial-geometry-arguments
|
|
|
464 props))
|
|
|
465 ;)
|
|
428
|
466 ;; The initial frame, which we are about to delete, may be
|
|
|
467 ;; the only frame with a minibuffer. If it is, create a
|
|
|
468 ;; new one.
|
|
|
469 (or (delq frame-initial-frame (minibuffer-frame-list))
|
|
|
470 (make-initial-minibuffer-frame nil))
|
|
|
471
|
|
|
472 ;; If the initial frame is serving as a surrogate
|
|
|
473 ;; minibuffer frame for any frames, we need to wean them
|
|
|
474 ;; onto a new frame. The default-minibuffer-frame
|
|
|
475 ;; variable must be handled similarly.
|
|
|
476 (let ((users-of-initial
|
|
|
477 (filtered-frame-list
|
|
|
478 #'(lambda (frame)
|
|
|
479 (and (not (eq frame frame-initial-frame))
|
|
|
480 (eq (window-frame
|
|
|
481 (minibuffer-window frame))
|
|
|
482 frame-initial-frame))))))
|
|
|
483 (if (or users-of-initial
|
|
|
484 (eq default-minibuffer-frame frame-initial-frame))
|
|
|
485
|
|
|
486 ;; Choose an appropriate frame. Prefer frames which
|
|
|
487 ;; are only minibuffers.
|
|
|
488 (let* ((new-surrogate
|
|
|
489 (car
|
|
|
490 (or (filtered-frame-list
|
|
|
491 #'(lambda (frame)
|
|
|
492 (eq 'only
|
|
|
493 (frame-property frame 'minibuffer))))
|
|
|
494 (minibuffer-frame-list))))
|
|
|
495 (new-minibuffer (minibuffer-window new-surrogate)))
|
|
|
496
|
|
|
497 (if (eq default-minibuffer-frame frame-initial-frame)
|
|
|
498 (setq default-minibuffer-frame new-surrogate))
|
|
|
499
|
|
|
500 ;; Wean the frames using frame-initial-frame as
|
|
|
501 ;; their minibuffer frame.
|
|
|
502 (mapcar
|
|
1942
|
503 #'(lambda (frame)
|
|
|
504 (set-frame-property frame 'minibuffer
|
|
|
505 new-minibuffer))
|
|
|
506 users-of-initial))))
|
|
428
|
507
|
|
|
508 ;; Redirect events enqueued at this frame to the new frame.
|
|
|
509 ;; Is this a good idea?
|
|
|
510 ;; Probably not, since this whole redirect-frame-focus
|
|
|
511 ;; stuff is a load of trash, and so is this function we're in.
|
|
|
512 ;; --ben
|
|
|
513 ;(redirect-frame-focus frame-initial-frame new)
|
|
|
514
|
|
|
515 ;; Finally, get rid of the old frame.
|
|
|
516 (delete-frame frame-initial-frame t))
|
|
|
517
|
|
|
518 ;; Otherwise, we don't need all that rigamarole; just apply
|
|
|
519 ;; the new properties.
|
|
|
520 (let (newprops allprops tail)
|
|
|
521 (setq allprops (append initial-frame-plist
|
|
|
522 default-frame-plist))
|
|
|
523 (if (lax-plist-member frame-initial-geometry-arguments 'height)
|
|
|
524 (laxremf allprops 'height))
|
|
|
525 (if (lax-plist-member frame-initial-geometry-arguments 'width)
|
|
|
526 (remf allprops 'width))
|
|
|
527 (if (lax-plist-member frame-initial-geometry-arguments 'left)
|
|
|
528 (laxremf allprops 'left))
|
|
|
529 (if (lax-plist-member frame-initial-geometry-arguments 'top)
|
|
|
530 (laxremf allprops 'top))
|
|
|
531 (setq tail allprops)
|
|
|
532 ;; Find just the props that have changed since we first
|
|
|
533 ;; made this frame. Those are the ones actually set by
|
|
|
534 ;; the init file. For those props whose values we already knew
|
|
|
535 ;; (such as those spec'd by command line options)
|
|
|
536 ;; it is undesirable to specify the parm again
|
|
|
537 ;; once the user has seen the frame and been able to alter it
|
|
|
538 ;; manually.
|
|
|
539 (while tail
|
|
|
540 (let (newval oldval)
|
|
|
541 (setq oldval (lax-plist-get frame-initial-frame-plist
|
|
|
542 (car tail)))
|
|
|
543 (setq newval (lax-plist-get allprops (car tail)))
|
|
|
544 (or (eq oldval newval)
|
|
|
545 (laxputf newprops (car tail) newval)))
|
|
|
546 (setq tail (cddr tail)))
|
|
|
547 (set-frame-properties frame-initial-frame newprops)
|
|
1942
|
548 ;; XEmacs change: omit the background manipulation
|
|
|
549 ; ;; If we changed the background color,
|
|
|
550 ; ;; we need to update the background-mode parameter
|
|
|
551 ; ;; and maybe some faces too.
|
|
|
552 ; (when (assq 'background-color newparms)
|
|
|
553 ; (unless (assq 'background-mode newparms)
|
|
|
554 ; (frame-set-background-mode frame-initial-frame))
|
|
|
555 ; (face-set-after-frame-default frame-initial-frame)))))
|
|
428
|
556 )))
|
|
|
557
|
|
|
558 ;; Restore the original buffer.
|
|
|
559 (set-buffer old-buffer)
|
|
|
560
|
|
|
561 ;; Make sure the initial frame can be GC'd if it is ever deleted.
|
|
|
562 ;; Make sure frame-notice-user-settings does nothing if called twice.
|
|
1942
|
563 (setq frame-notice-user-settings nil)
|
|
428
|
564 (setq frame-initial-frame nil)))
|
|
|
565
|
|
|
566 (defun make-initial-minibuffer-frame (device)
|
|
|
567 (let ((props (append '(minibuffer only)
|
|
|
568 (safe-alist-to-plist minibuffer-frame-plist))))
|
|
|
569 (make-frame props device)))
|
|
|
570
|
|
|
571
|
|
|
572 ;;;; Creation of additional frames, and other frame miscellanea
|
|
|
573
|
|
1942
|
574 (defun modify-all-frames-properties (plist)
|
|
|
575 "Modify all current and future frames' parameters according to PLIST.
|
|
|
576 This changes `default-frame-plist' and possibly `initial-frame-plist'.
|
|
|
577 See `set-frame-properties' for more information."
|
|
|
578 (dolist (frame (frame-list))
|
|
|
579 (set-frame-properties frame plist))
|
|
|
580
|
|
|
581 ;; XEmacs change: iterate over plists instead of alists
|
|
|
582 (map-plist
|
|
|
583 #'(lambda (prop val)
|
|
|
584 ;; initial-frame-plist needs setting only when
|
|
|
585 ;; frame-notice-user-settings is true
|
|
|
586 (and frame-notice-user-settings
|
|
|
587 (lax-plist-remprop initial-frame-plist prop))
|
|
|
588 (lax-plist-remprop default-frame-plist prop))
|
|
|
589 plist)
|
|
|
590
|
|
|
591 (and frame-notice-user-settings
|
|
|
592 (setq initial-frame-plist (append initial-frame-plist plist)))
|
|
|
593 (setq default-frame-plist (append default-frame-plist plist)))
|
|
|
594
|
|
428
|
595 (defun get-other-frame ()
|
|
1942
|
596 "Return some frame other than the current frame.
|
|
|
597 Create one if necessary. Note that the minibuffer frame, if separate,
|
|
|
598 is not considered (see `next-frame')."
|
|
428
|
599 (let* ((this (selected-frame))
|
|
|
600 ;; search visible frames first
|
|
|
601 (next (next-frame this 'visible-nomini)))
|
|
|
602 ;; then search iconified frames
|
|
|
603 (if (eq this next)
|
|
|
604 (setq next (next-frame 'visible-iconic-nomini)))
|
|
|
605 (if (eq this next)
|
|
|
606 ;; otherwise, make a new frame
|
|
|
607 (make-frame)
|
|
|
608 next)))
|
|
|
609
|
|
|
610 (defun next-multiframe-window ()
|
|
|
611 "Select the next window, regardless of which frame it is on."
|
|
|
612 (interactive)
|
|
|
613 (select-window (next-window (selected-window)
|
|
|
614 (> (minibuffer-depth) 0)
|
|
1942
|
615 t))
|
|
|
616 ;; XEmacs change: select-window already selects the containing frame
|
|
|
617 ;(select-frame-set-input-focus (selected-frame))
|
|
|
618 )
|
|
428
|
619
|
|
|
620 (defun previous-multiframe-window ()
|
|
|
621 "Select the previous window, regardless of which frame it is on."
|
|
|
622 (interactive)
|
|
|
623 (select-window (previous-window (selected-window)
|
|
|
624 (> (minibuffer-depth) 0)
|
|
1942
|
625 t))
|
|
|
626 ;; XEmacs change: select-window already selects the containing frame
|
|
|
627 ;(select-frame-set-input-focus (selected-frame))
|
|
|
628 )
|
|
428
|
629
|
|
1942
|
630 ;; XEmacs change: Emacs has make-frame-on-display
|
|
428
|
631 (defun make-frame-on-device (type connection &optional props)
|
|
|
632 "Create a frame of type TYPE on CONNECTION.
|
|
|
633 TYPE should be a symbol naming the device type, i.e. one of
|
|
|
634
|
|
|
635 x An X display. CONNECTION should be a standard display string
|
|
|
636 such as \"unix:0\", or nil for the display specified on the
|
|
|
637 command line or in the DISPLAY environment variable. Only if
|
|
|
638 support for X was compiled into XEmacs.
|
|
|
639 tty A standard TTY connection or terminal. CONNECTION should be
|
|
|
640 a TTY device name such as \"/dev/ttyp2\" (as determined by
|
|
|
641 the Unix command `tty') or nil for XEmacs' standard input
|
|
|
642 and output (usually the TTY in which XEmacs started). Only
|
|
|
643 if support for TTY's was compiled into XEmacs.
|
|
462
|
644 gtk A GTK device.
|
|
428
|
645 ns A connection to a machine running the NeXTstep windowing
|
|
|
646 system. Not currently implemented.
|
|
|
647 mswindows A connection to a machine running Microsoft Windows NT or
|
|
|
648 Windows 95/97.
|
|
|
649 pc A direct-write MS-DOS frame. Not currently implemented.
|
|
|
650
|
|
|
651 PROPS should be a plist of properties, as in the call to `make-frame'.
|
|
|
652
|
|
|
653 If a connection to CONNECTION already exists, it is reused; otherwise,
|
|
|
654 a new connection is opened."
|
|
|
655 (make-frame props (make-device type connection props)))
|
|
|
656
|
|
1942
|
657 ;; XEmacs omission: Emacs has make-frame-command here, but it reduces to
|
|
|
658 ;; make-frame for us.
|
|
|
659
|
|
|
660 ;; XEmacs omission: the following 2 variables are not yet implemented.
|
|
|
661 ;(defvar before-make-frame-hook nil
|
|
|
662 ; "Functions to run before a frame is created.")
|
|
|
663 ;
|
|
|
664 ;(defvar after-make-frame-functions nil
|
|
|
665 ; "Functions to run after a frame is created.
|
|
|
666 ;The functions are run with one arg, the newly created frame.")
|
|
|
667 ;
|
|
|
668 (defvar after-setting-font-hook nil
|
|
|
669 "Functions to run after a frame's font has been changed.")
|
|
|
670
|
|
428
|
671 ;; Alias, kept temporarily.
|
|
|
672 (defalias 'new-frame 'make-frame)
|
|
1942
|
673 (make-obsolete 'new-frame 'make-frame)
|
|
428
|
674
|
|
1942
|
675 ;; XEmacs change: Emacs has make-frame here. We have it in C, so no need for
|
|
|
676 ;; frame-creation-function.
|
|
428
|
677
|
|
1942
|
678 ;; XEmacs addition: support optional DEVICE argument.
|
|
428
|
679 (defun filtered-frame-list (predicate &optional device)
|
|
|
680 "Return a list of all live frames which satisfy PREDICATE.
|
|
|
681 If optional second arg DEVICE is non-nil, restrict the frames
|
|
|
682 returned to that device."
|
|
|
683 (let ((frames (if device (device-frame-list device)
|
|
|
684 (frame-list)))
|
|
|
685 good-frames)
|
|
|
686 (while (consp frames)
|
|
|
687 (if (funcall predicate (car frames))
|
|
|
688 (setq good-frames (cons (car frames) good-frames)))
|
|
|
689 (setq frames (cdr frames)))
|
|
|
690 good-frames))
|
|
|
691
|
|
1942
|
692 ;; XEmacs addition: support optional DEVICE argument.
|
|
428
|
693 (defun minibuffer-frame-list (&optional device)
|
|
|
694 "Return a list of all frames with their own minibuffers.
|
|
|
695 If optional second arg DEVICE is non-nil, restrict the frames
|
|
|
696 returned to that device."
|
|
|
697 (filtered-frame-list
|
|
|
698 #'(lambda (frame)
|
|
|
699 (eq frame (window-frame (minibuffer-window frame))))
|
|
|
700 device))
|
|
|
701
|
|
1942
|
702 ;; XEmacs omission: Emacs has frames-on-display-list here, but that is
|
|
|
703 ;; essentially equivalent to supplying the optional DEVICE argument to
|
|
|
704 ;; filtered-frame-list.
|
|
|
705
|
|
|
706 ;; XEmacs addition: the following two functions make life a lot simpler below.
|
|
|
707 (defsubst display-frame (display)
|
|
|
708 "Return the active frame for DISPLAY.
|
|
|
709 DISPLAY may be a frame, a device, or a console. If it is omitted or nil,
|
|
|
710 it defaults to the selected frame."
|
|
|
711 (cond
|
|
|
712 ((null display) (selected-frame))
|
|
|
713 ((framep display) display)
|
|
|
714 ((devicep display) (selected-frame display))
|
|
|
715 ((consolep display) (selected-frame (car (console-device-list display))))
|
|
|
716 (t (error 'wrong-type-argument "Not a frame, device, or console" display))))
|
|
|
717
|
|
|
718 (defsubst display-device (display)
|
|
|
719 "Return the device for DISPLAY.
|
|
|
720 DISPLAY may be a frame, a device, or a console. If it is omitted or nil,
|
|
|
721 it defaults to the selected frame."
|
|
|
722 (cond
|
|
|
723 ((null display) (selected-device))
|
|
|
724 ((framep display) (frame-device display))
|
|
|
725 ((devicep display) display)
|
|
|
726 ((consolep display) (car (console-device-list display)))
|
|
|
727 (t (error 'wrong-type-argument "Not a frame, device, or console" display))))
|
|
|
728
|
|
|
729 ;; Emacs compatibility function. We do not allow display names of the type
|
|
|
730 ;; HOST:SERVER.SCREEN as Emacs does, but we do handle devices and consoles.
|
|
|
731 (defun framep-on-display (&optional display)
|
|
|
732 "Return the type of frames on DISPLAY.
|
|
|
733 DISPLAY may be a frame, a device, or a console. If it is a frame, its type
|
|
|
734 is returned. If DISPLAY is omitted or nil, it defaults to the selected
|
|
|
735 frame. All frames on a given device or console are of the same type."
|
|
|
736 (cond
|
|
|
737 ((null display) (frame-type (selected-frame)))
|
|
|
738 ((framep display) (frame-type display))
|
|
|
739 ((devicep display) (device-type display))
|
|
|
740 ((consolep display) (console-type display))
|
|
|
741 (t (error 'wrong-type-argument "Not a frame, device, or console" display))))
|
|
|
742
|
|
|
743 ;; XEmacs addition: Emacs does not have this function.
|
|
428
|
744 (defun frame-minibuffer-only-p (frame)
|
|
|
745 "Return non-nil if FRAME is a minibuffer-only frame."
|
|
|
746 (eq (frame-root-window frame) (minibuffer-window frame)))
|
|
|
747
|
|
|
748 (defun frame-remove-geometry-props (plist)
|
|
|
749 "Return the property list PLIST, but with geometry specs removed.
|
|
|
750 This deletes all bindings in PLIST for `top', `left', `width',
|
|
|
751 `height', `user-size' and `user-position' properties.
|
|
|
752 Emacs uses this to avoid overriding explicit moves and resizings from
|
|
|
753 the user during startup."
|
|
|
754 (setq plist (canonicalize-lax-plist (copy-sequence plist)))
|
|
442
|
755 (mapcar #'(lambda (property)
|
|
|
756 (if (lax-plist-member plist property)
|
|
428
|
757 (progn
|
|
|
758 (setq frame-initial-geometry-arguments
|
|
442
|
759 (cons property
|
|
|
760 (cons (lax-plist-get plist property)
|
|
428
|
761 frame-initial-geometry-arguments)))
|
|
442
|
762 (setq plist (lax-plist-remprop plist property)))))
|
|
428
|
763 '(height width top left user-size user-position))
|
|
|
764 plist)
|
|
|
765
|
|
1942
|
766 ;; XEmacs change: Emacs has focus-follows-mouse here, which lets them
|
|
|
767 ;; Customize it. XEmacs has it builtin. Should that change?
|
|
|
768
|
|
|
769 ;; XEmacs change: we have focus-frame instead of multiple foo-focus-frame
|
|
|
770 ;; functions.
|
|
|
771 (defun select-frame-set-input-focus (frame)
|
|
|
772 "Select FRAME, raise it, and set input focus, if possible."
|
|
|
773 (raise-frame frame)
|
|
|
774 (focus-frame frame) ;; This also selects FRAME
|
|
|
775 ;; XEmacs change: This is a bad idea; you should in general never warp the
|
|
|
776 ;; pointer unless the user asks for it.
|
|
|
777 ;;(if focus-follows-mouse
|
|
|
778 ;; (set-mouse-position (selected-window) (1- (frame-width frame)) 0)))
|
|
|
779 )
|
|
|
780
|
|
428
|
781 (defun other-frame (arg)
|
|
|
782 "Select the ARG'th different visible frame, and raise it.
|
|
|
783 All frames are arranged in a cyclic order.
|
|
|
784 This command selects the frame ARG steps away in that order.
|
|
|
785 A negative ARG moves in the opposite order.
|
|
|
786
|
|
1942
|
787 To make this command work properly, you must tell Emacs
|
|
|
788 how the system (or the window manager) generally handles
|
|
|
789 focus-switching between windows. If moving the mouse onto a window
|
|
|
790 selects it (gives it focus), set `focus-follows-mouse' to t.
|
|
|
791 Otherwise, that variable should be nil."
|
|
428
|
792 (interactive "p")
|
|
|
793 (let ((frame (selected-frame)))
|
|
|
794 (while (> arg 0)
|
|
|
795 (setq frame (next-frame frame 'visible-nomini))
|
|
|
796 (setq arg (1- arg)))
|
|
|
797 (while (< arg 0)
|
|
|
798 (setq frame (previous-frame frame 'visible-nomini))
|
|
|
799 (setq arg (1+ arg)))
|
|
1942
|
800 (select-frame-set-input-focus frame)))
|
|
|
801
|
|
|
802 (defun iconify-or-deiconify-frame ()
|
|
|
803 "Iconify the selected frame, or deiconify if it's currently an icon."
|
|
|
804 (interactive)
|
|
|
805 (if (lax-plist-get (frame-properties) 'visibility)
|
|
|
806 (iconify-frame)
|
|
|
807 (make-frame-visible)))
|
|
|
808
|
|
|
809 (defun make-frame-names-alist ()
|
|
|
810 (let* ((current-frame (selected-frame))
|
|
|
811 (falist
|
|
|
812 (cons
|
|
|
813 (cons (frame-property current-frame 'name) current-frame) nil))
|
|
|
814 (frame (next-frame current-frame t)))
|
|
|
815 (while (not (eq frame current-frame))
|
|
|
816 (progn
|
|
|
817 (setq falist (cons (cons (frame-property frame 'name) frame) falist))
|
|
|
818 (setq frame (next-frame frame t))))
|
|
|
819 falist))
|
|
|
820
|
|
|
821 (defvar frame-name-history nil)
|
|
|
822 (defun select-frame-by-name (name)
|
|
|
823 "Select the frame on the current terminal whose name is NAME and raise it.
|
|
|
824 If there is no frame by that name, signal an error."
|
|
|
825 (interactive
|
|
|
826 (let* ((frame-names-alist (make-frame-names-alist))
|
|
|
827 (default (car (car frame-names-alist)))
|
|
|
828 (input (completing-read
|
|
|
829 (format "Select Frame (default %s): " default)
|
|
|
830 frame-names-alist nil t nil 'frame-name-history default)))
|
|
|
831 ;; XEmacs change: use the last param of completing-read to simplify.
|
|
|
832 (list input)))
|
|
|
833 (let* ((frame-names-alist (make-frame-names-alist))
|
|
|
834 (frame (cdr (assoc name frame-names-alist))))
|
|
|
835 (or frame
|
|
|
836 (error "There is no frame named `%s'" name))
|
|
|
837 (make-frame-visible frame)
|
|
|
838 ;; XEmacs change: make-frame-visible implies (raise-frame)
|
|
|
839 ;; (raise-frame frame)
|
|
|
840 ;; XEmacs change: we defined this function, might as well use it.
|
|
|
841 (select-frame-set-input-focus frame)))
|
|
428
|
842
|
|
|
843 ;; XEmacs-added utility functions
|
|
|
844
|
|
|
845 (defmacro save-selected-frame (&rest body)
|
|
|
846 "Execute forms in BODY, then restore the selected frame.
|
|
|
847 The value returned is the value of the last form in BODY."
|
|
|
848 (let ((old-frame (gensym "ssf")))
|
|
|
849 `(let ((,old-frame (selected-frame)))
|
|
|
850 (unwind-protect
|
|
|
851 (progn ,@body)
|
|
|
852 (select-frame ,old-frame)))))
|
|
|
853
|
|
|
854 (defmacro with-selected-frame (frame &rest body)
|
|
|
855 "Execute forms in BODY with FRAME as the selected frame.
|
|
|
856 The value returned is the value of the last form in BODY."
|
|
|
857 `(save-selected-frame
|
|
|
858 (select-frame ,frame)
|
|
|
859 ,@body))
|
|
|
860
|
|
1942
|
861 ; This is in C in Emacs
|
|
428
|
862 (defun frame-list ()
|
|
|
863 "Return a list of all frames on all devices/consoles."
|
|
|
864 ;; Lists are copies, so nconc is safe here.
|
|
|
865 (apply 'nconc (mapcar 'device-frame-list (device-list))))
|
|
|
866
|
|
|
867 (defun frame-type (&optional frame)
|
|
|
868 "Return the type of the specified frame (e.g. `x' or `tty').
|
|
|
869 This is equivalent to the type of the frame's device.
|
|
|
870 Value is `tty' for a tty frame (a character-only terminal),
|
|
|
871 `x' for a frame that is an X window,
|
|
|
872 `ns' for a frame that is a NeXTstep window (not yet implemented),
|
|
440
|
873 `mswindows' for a frame that is a MS Windows desktop window,
|
|
|
874 `msprinter' for a frame that is a MS Windows print job,
|
|
428
|
875 `stream' for a stream frame (which acts like a stdio stream), and
|
|
|
876 `dead' for a deleted frame."
|
|
|
877 (or frame (setq frame (selected-frame)))
|
|
|
878 (if (not (frame-live-p frame)) 'dead
|
|
|
879 (device-type (frame-device frame))))
|
|
|
880
|
|
|
881 (defun device-or-frame-p (object)
|
|
|
882 "Return non-nil if OBJECT is a device or frame."
|
|
|
883 (or (devicep object)
|
|
|
884 (framep object)))
|
|
|
885
|
|
|
886 (defun device-or-frame-type (device-or-frame)
|
|
|
887 "Return the type (e.g. `x' or `tty') of DEVICE-OR-FRAME.
|
|
|
888 DEVICE-OR-FRAME should be a device or a frame object. See `device-type'
|
|
|
889 for a description of the possible types."
|
|
|
890 (if (devicep device-or-frame)
|
|
|
891 (device-type device-or-frame)
|
|
|
892 (frame-type device-or-frame)))
|
|
|
893
|
|
|
894 (defun fw-frame (obj)
|
|
|
895 "Given a frame or window, return the associated frame.
|
|
|
896 Return nil otherwise."
|
|
|
897 (cond ((windowp obj) (window-frame obj))
|
|
|
898 ((framep obj) obj)
|
|
|
899 (t nil)))
|
|
|
900
|
|
|
901
|
|
|
902 ;;;; Frame configurations
|
|
|
903
|
|
|
904 (defun current-frame-configuration ()
|
|
|
905 "Return a list describing the positions and states of all frames.
|
|
|
906 Its car is `frame-configuration'.
|
|
|
907 Each element of the cdr is a list of the form (FRAME PLIST WINDOW-CONFIG),
|
|
|
908 where
|
|
|
909 FRAME is a frame object,
|
|
|
910 PLIST is a property list specifying some of FRAME's properties, and
|
|
|
911 WINDOW-CONFIG is a window configuration object for FRAME."
|
|
|
912 (cons 'frame-configuration
|
|
|
913 (mapcar (function
|
|
|
914 (lambda (frame)
|
|
|
915 (list frame
|
|
|
916 (frame-properties frame)
|
|
|
917 (current-window-configuration frame))))
|
|
|
918 (frame-list))))
|
|
|
919
|
|
|
920 (defun set-frame-configuration (configuration &optional nodelete)
|
|
|
921 "Restore the frames to the state described by CONFIGURATION.
|
|
|
922 Each frame listed in CONFIGURATION has its position, size, window
|
|
|
923 configuration, and other properties set as specified in CONFIGURATION.
|
|
|
924 Ordinarily, this function deletes all existing frames not
|
|
|
925 listed in CONFIGURATION. But if optional second argument NODELETE
|
|
|
926 is given and non-nil, the unwanted frames are iconified instead."
|
|
|
927 (or (frame-configuration-p configuration)
|
|
|
928 (signal 'wrong-type-argument
|
|
|
929 (list 'frame-configuration-p configuration)))
|
|
1942
|
930 (let ((config-alist (cdr configuration))
|
|
428
|
931 frames-to-delete)
|
|
1942
|
932 (mapc #'(lambda (frame)
|
|
|
933 (let ((properties (assq frame config-alist)))
|
|
|
934 (if properties
|
|
|
935 (progn
|
|
|
936 (set-frame-properties
|
|
|
937 frame
|
|
|
938 ;; Since we can't set a frame's minibuffer status,
|
|
|
939 ;; we might as well omit the parameter altogether.
|
|
|
940 (lax-plist-remprop (nth 1 properties) 'minibuffer))
|
|
|
941 (set-window-configuration (nth 2 properties)))
|
|
|
942 (setq frames-to-delete (cons frame frames-to-delete)))))
|
|
428
|
943 (frame-list))
|
|
|
944 (if nodelete
|
|
|
945 ;; Note: making frames invisible here was tried
|
|
|
946 ;; but led to some strange behavior--each time the frame
|
|
|
947 ;; was made visible again, the window manager asked afresh
|
|
|
948 ;; for where to put it.
|
|
1942
|
949 (mapc #'iconify-frame frames-to-delete)
|
|
|
950 (mapc #'delete-frame frames-to-delete))))
|
|
428
|
951
|
|
1942
|
952 ; XEmacs change: this function is in subr.el in Emacs.
|
|
|
953 ; That's because they don't always include frame.el, while we do.
|
|
428
|
954
|
|
|
955 (defun frame-configuration-p (object)
|
|
|
956 "Return non-nil if OBJECT seems to be a frame configuration.
|
|
|
957 Any list whose car is `frame-configuration' is assumed to be a frame
|
|
|
958 configuration."
|
|
|
959 (and (consp object)
|
|
|
960 (eq (car object) 'frame-configuration)))
|
|
|
961
|
|
|
962
|
|
1942
|
963 ;;;; Convenience functions for accessing and interactively changing
|
|
|
964 ;;;; frame parameters.
|
|
|
965
|
|
|
966 (defun frame-height (&optional frame)
|
|
|
967 "Return number of lines available for display on FRAME.
|
|
|
968 If FRAME is omitted, describe the currently selected frame."
|
|
|
969 (frame-property frame 'height))
|
|
|
970
|
|
|
971 (defun frame-width (&optional frame)
|
|
|
972 "Return number of columns available for display on FRAME.
|
|
|
973 If FRAME is omitted, describe the currently selected frame."
|
|
|
974 (frame-property frame 'width))
|
|
|
975
|
|
|
976 (defalias 'set-default-font 'set-frame-font)
|
|
|
977
|
|
|
978 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
979 (defun set-frame-font (font-name &optional keep-size)
|
|
|
980 "Set the font of the selected frame to FONT-NAME.
|
|
|
981 When called interactively, prompt for the name of the font to use.
|
|
|
982 To get the frame's current default font, use `(face-font-name 'default)'.
|
|
|
983
|
|
|
984 The default behavior is to keep the numbers of lines and columns in
|
|
|
985 the frame, thus may change its pixel size. If optional KEEP-SIZE is
|
|
|
986 non-nil (interactively, prefix argument) the current frame size (in
|
|
|
987 pixels) is kept by adjusting the numbers of the lines and columns."
|
|
|
988 (interactive
|
|
|
989 (let* ((frame (selected-frame))
|
|
|
990 (completion-ignore-case t)
|
|
|
991 (font (completing-read "Font name: "
|
|
|
992 (mapcar #'list
|
|
2527
|
993 (font-list "*" frame))
|
|
1942
|
994 nil nil nil nil
|
|
|
995 (face-font-name 'default frame))))
|
|
|
996 (list font current-prefix-arg)))
|
|
|
997 (let* ((frame (selected-frame))
|
|
|
998 (fht (frame-pixel-height frame))
|
|
|
999 (fwd (frame-pixel-width frame))
|
|
|
1000 (face-list-to-change (face-list)))
|
|
|
1001 (when (eq (device-type) 'mswindows)
|
|
|
1002 (setq face-list-to-change
|
|
|
1003 (delq 'border-glyph face-list-to-change)))
|
|
|
1004 ;; FIXME: Is it sufficient to just change the default face, due to
|
|
|
1005 ;; face inheritance?
|
|
|
1006 (dolist (face face-list-to-change)
|
|
|
1007 (when (face-font-instance face)
|
|
|
1008 (condition-case c
|
|
|
1009 (set-face-font face font-name frame)
|
|
|
1010 (error
|
|
|
1011 (display-error c nil)
|
|
|
1012 (sit-for 1)))))
|
|
|
1013 (if keep-size
|
|
|
1014 (set-frame-pixel-size frame fwd fht)))
|
|
|
1015 (run-hooks 'after-setting-font-hook))
|
|
|
1016
|
|
|
1017 (defun set-frame-property (frame prop val)
|
|
|
1018 "Set property PROP of FRAME to VAL. See `set-frame-properties'."
|
|
|
1019 (set-frame-properties frame (list prop val)))
|
|
|
1020
|
|
|
1021 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
1022 (defun set-background-color (color-name)
|
|
|
1023 "Set the background color of the selected frame to COLOR-NAME.
|
|
|
1024 When called interactively, prompt for the name of the color to use.
|
|
|
1025 To get the frame's current background color, use
|
|
|
1026 `(face-background-name 'default)'."
|
|
|
1027 (interactive (list (read-color "Color: ")))
|
|
|
1028 ;; (set-face-foreground 'text-cursor color-name (selected-frame))
|
|
|
1029 (set-face-background 'default color-name (selected-frame)))
|
|
|
1030
|
|
|
1031 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
1032 (defun set-foreground-color (color-name)
|
|
|
1033 "Set the foreground color of the selected frame to COLOR-NAME.
|
|
|
1034 When called interactively, prompt for the name of the color to use.
|
|
|
1035 To get the frame's current foreground color, use
|
|
|
1036 `(face-foreground-name 'default)'."
|
|
|
1037 (interactive (list (read-color "Color: ")))
|
|
|
1038 (set-face-foreground 'default color-name (selected-frame)))
|
|
|
1039
|
|
|
1040 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
1041 (defun set-cursor-color (color-name)
|
|
|
1042 "Set the text cursor color of the selected frame to COLOR-NAME.
|
|
|
1043 When called interactively, prompt for the name of the color to use.
|
|
|
1044 To get the frame's current cursor color, use
|
|
|
1045 '(face-background-name 'text-cursor)'."
|
|
|
1046 (interactive (list (read-color "Color: ")))
|
|
|
1047 (set-face-background 'text-cursor color-name (selected-frame)))
|
|
|
1048
|
|
|
1049 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
1050 (defun set-mouse-color (color-name)
|
|
|
1051 "Set the color of the mouse pointer of the selected frame to COLOR-NAME.
|
|
|
1052 When called interactively, prompt for the name of the color to use.
|
|
|
1053 To get the frame's current mouse color, use
|
|
|
1054 `(face-foreground-name 'pointer)'."
|
|
|
1055 (interactive (list (read-color "Color: ")))
|
|
|
1056 (set-face-foreground 'pointer color-name (selected-frame)))
|
|
|
1057
|
|
|
1058 ;; XEmacs change: this function differs significantly from Emacs.
|
|
|
1059 (defun set-border-color (color-name)
|
|
|
1060 "Set the color of the border of the selected frame to COLOR-NAME.
|
|
|
1061 When called interactively, prompt for the name of the color to use.
|
|
|
1062 To get the frame's current border color, use
|
|
|
1063 `(face-foreground-name 'border-glyph)'."
|
|
|
1064 (interactive (list (read-color "Color: ")))
|
|
|
1065 (set-face-foreground 'border-glyph color-name (selected-frame)))
|
|
|
1066
|
|
|
1067 ;;; BEGIN XEmacs addition
|
|
|
1068 ;;; This is the traditional XEmacs auto-raise and auto-lower, which applies
|
|
|
1069 ;;; to all frames.
|
|
|
1070
|
|
|
1071 (defcustom auto-raise-frame nil
|
|
|
1072 "*If true, frames will be raised to the top when selected.
|
|
|
1073 Under X, most ICCCM-compliant window managers will have an option to do this
|
|
|
1074 for you, but this variable is provided in case you're using a broken WM."
|
|
|
1075 :type 'boolean
|
|
|
1076 :group 'frames)
|
|
|
1077
|
|
|
1078 (defcustom auto-lower-frame nil
|
|
|
1079 "*If true, frames will be lowered to the bottom when no longer selected.
|
|
|
1080 Under X, most ICCCM-compliant window managers will have an option to do this
|
|
|
1081 for you, but this variable is provided in case you're using a broken WM."
|
|
|
1082 :type 'boolean
|
|
|
1083 :group 'frames)
|
|
|
1084
|
|
|
1085 (defun default-select-frame-hook ()
|
|
|
1086 "Implement the `auto-raise-frame' variable.
|
|
|
1087 For use as the value of `select-frame-hook'."
|
|
|
1088 (if auto-raise-frame (raise-frame (selected-frame))))
|
|
428
|
1089
|
|
1942
|
1090 (defun default-deselect-frame-hook ()
|
|
|
1091 "Implement the `auto-lower-frame' variable.
|
|
|
1092 For use as the value of `deselect-frame-hook'."
|
|
|
1093 (if auto-lower-frame (lower-frame (selected-frame)))
|
|
|
1094 (highlight-extent nil nil))
|
|
|
1095
|
|
|
1096 (or select-frame-hook
|
|
|
1097 (add-hook 'select-frame-hook 'default-select-frame-hook))
|
|
|
1098
|
|
|
1099 (or deselect-frame-hook
|
|
|
1100 (add-hook 'deselect-frame-hook 'default-deselect-frame-hook))
|
|
|
1101
|
|
|
1102 ;;; END XEmacs addition
|
|
|
1103 ;;; Following is the Emacs auto-raise/auto-lower interface, which lets the
|
|
|
1104 ;;; user select individual frames to auto-raise and auto-lower
|
|
|
1105
|
|
|
1106 ;; XEmacs addition: the next two variables do not appear in Emacs
|
|
|
1107 (defvar auto-raise-specifier (make-boolean-specifier auto-raise-frame)
|
|
|
1108 "Specifier that determines which frames should auto-raise.
|
|
|
1109 A value of `t' means that a frame auto-raises; `nil' means it does not.")
|
|
|
1110
|
|
|
1111 (defvar auto-lower-specifier (make-boolean-specifier auto-lower-frame)
|
|
|
1112 "Specifier that determines which frames should auto-lower.
|
|
|
1113 A value of `t' means that a frame auto-lowers; `nil' means it does not.")
|
|
|
1114
|
|
|
1115 ;; XEmacs change: use specifiers instead of frame-parameters
|
|
|
1116 (defun auto-raise-mode (arg)
|
|
|
1117 "Toggle whether or not the selected frame should auto-raise.
|
|
|
1118 With arg, turn auto-raise mode on if and only if arg is positive.
|
|
|
1119 Note that this controls Emacs's own auto-raise feature.
|
|
|
1120 Some window managers allow you to enable auto-raise for certain windows.
|
|
|
1121 You can use that for Emacs windows if you wish, but if you do,
|
|
|
1122 that is beyond the control of Emacs and this command has no effect on it."
|
|
|
1123 (interactive "P")
|
|
|
1124 (if (null arg)
|
|
|
1125 (setq arg
|
|
|
1126 (if (specifier-instance auto-raise-specifier (selected-frame))
|
|
|
1127 -1 1)))
|
|
|
1128 (if (> arg 0)
|
|
|
1129 (progn
|
|
|
1130 (raise-frame (selected-frame))
|
|
|
1131 (add-hook 'select-frame-hook 'default-select-frame-hook))
|
|
|
1132 (set-specifier auto-raise-specifier (> arg 0) (selected-frame))))
|
|
|
1133
|
|
|
1134 ;; XEmacs change: use specifiers instead of frame-parameters
|
|
|
1135 (defun auto-lower-mode (arg)
|
|
|
1136 "Toggle whether or not the selected frame should auto-lower.
|
|
|
1137 With arg, turn auto-lower mode on if and only if arg is positive.
|
|
|
1138 Note that this controls Emacs's own auto-lower feature.
|
|
|
1139 Some window managers allow you to enable auto-lower for certain windows.
|
|
|
1140 You can use that for Emacs windows if you wish, but if you do,
|
|
|
1141 that is beyond the control of Emacs and this command has no effect on it."
|
|
|
1142 (interactive "P")
|
|
|
1143 (if (null arg)
|
|
|
1144 (setq arg
|
|
|
1145 (if (specifier-instance auto-lower-specifier (selected-frame))
|
|
|
1146 -1 1)))
|
|
|
1147 (if (> arg 0)
|
|
|
1148 (progn
|
|
|
1149 (lower-frame (selected-frame))
|
|
|
1150 (add-hook 'deselect-frame-hook 'default-deselect-frame-hook))
|
|
|
1151 (set-specifier auto-lower-specifier (> arg 0) (selected-frame))))
|
|
428
|
1152
|
|
1942
|
1153 ;; XEmacs omission: XEmacs does not support changing the frame name
|
|
|
1154 ;(defun set-frame-name (name)
|
|
|
1155 ; "Set the name of the selected frame to NAME.
|
|
|
1156 ;When called interactively, prompt for the name of the frame.
|
|
|
1157 ;The frame name is displayed on the modeline if the terminal displays only
|
|
|
1158 ;one frame, otherwise the name is displayed on the frame's caption bar."
|
|
|
1159 ; (interactive "sFrame name: ")
|
|
|
1160 ; (modify-frame-parameters (selected-frame)
|
|
|
1161 ; (list (cons 'name name))))
|
|
|
1162
|
|
|
1163 ;; XEmacs omission: XEmacs attaches scrollbars to windows, not frames.
|
|
|
1164 ;; See window-hscroll and ... what? window-start?
|
|
|
1165 ;(defun frame-current-scroll-bars (&optional frame)
|
|
|
1166 ; "Return the current scroll-bar settings in frame FRAME.
|
|
|
1167 ;Value is a cons (VERTICAL . HORISONTAL) where VERTICAL specifies the
|
|
|
1168 ;current location of the vertical scroll-bars (left, right, or nil),
|
|
|
1169 ;and HORISONTAL specifies the current location of the horisontal scroll
|
|
|
1170 ;bars (top, bottom, or nil)."
|
|
|
1171 ; (let ((vert (frame-parameter frame 'vertical-scroll-bars))
|
|
|
1172 ; (hor nil))
|
|
|
1173 ; (unless (memq vert '(left right nil))
|
|
|
1174 ; (setq vert default-frame-scroll-bars))
|
|
|
1175 ; (cons vert hor)))
|
|
|
1176
|
|
|
1177 ;;;; Frame/display capabilities.
|
|
|
1178 (defun display-mouse-p (&optional display)
|
|
|
1179 "Return non-nil if DISPLAY has a mouse available.
|
|
|
1180 DISPLAY can be a frame, a device, a console, or nil (meaning the
|
|
|
1181 selected frame)."
|
|
|
1182 (case (framep-on-display display)
|
|
|
1183 ;; We assume X, NeXTstep, and GTK *always* have a pointing device
|
|
|
1184 ((x ns gtk) t)
|
|
2509
|
1185 (mswindows (> (declare-boundp mswindows-num-mouse-buttons) 0))
|
|
1942
|
1186 (tty
|
|
2367
|
1187 (and-fboundp 'gpm-is-supported-p
|
|
|
1188 (gpm-is-supported-p (display-device display))))
|
|
1942
|
1189 (t nil)))
|
|
|
1190
|
|
|
1191 (defun display-popup-menus-p (&optional display)
|
|
|
1192 "Return non-nil if popup menus are supported on DISPLAY.
|
|
|
1193 DISPLAY can be a frame, a device, a console, or nil (meaning the selected
|
|
|
1194 frame). Support for popup menus requires that the mouse be available."
|
|
|
1195 (and
|
|
|
1196 (memq (framep-on-display display) '(x ns gtk mswindows))
|
|
|
1197 (display-mouse-p display)))
|
|
|
1198
|
|
|
1199 (defun display-graphic-p (&optional display)
|
|
|
1200 "Return non-nil if DISPLAY is a graphic display.
|
|
|
1201 Graphical displays are those which are capable of displaying several
|
|
|
1202 frames and several different fonts at once. This is true for displays
|
|
|
1203 that use a window system such as X, and false for text-only terminals.
|
|
|
1204 DISPLAY can be a frame, a device, a console, or nil (meaning the selected
|
|
|
1205 frame)."
|
|
|
1206 (memq (framep-on-display display) '(x ns gtk mswindows)))
|
|
|
1207
|
|
|
1208 (defun display-images-p (&optional display)
|
|
|
1209 "Return non-nil if DISPLAY can display images.
|
|
|
1210 DISPLAY can be a frame, a device, a console, or nil (meaning the selected
|
|
|
1211 frame)."
|
|
|
1212 (display-graphic-p display))
|
|
|
1213
|
|
|
1214 (defalias 'display-multi-frame-p 'display-graphic-p)
|
|
|
1215 (defalias 'display-multi-font-p 'display-graphic-p)
|
|
428
|
1216
|
|
1942
|
1217 (defun display-selections-p (&optional display)
|
|
|
1218 "Return non-nil if DISPLAY supports selections.
|
|
|
1219 A selection is a way to transfer text or other data between programs
|
|
|
1220 via special system buffers called `selection' or `cut buffer' or
|
|
|
1221 `clipboard'.
|
|
|
1222 DISPLAY can be a frame, a device, a console, or nil (meaning the selected
|
|
|
1223 frame)."
|
|
|
1224 (memq (framep-on-display display) '(x ns gtk mswindows)))
|
|
|
1225
|
|
|
1226 (defun display-screens (&optional display)
|
|
|
1227 "Return the number of screens associated with DISPLAY."
|
|
|
1228 (device-num-screens (display-device display)))
|
|
|
1229
|
|
|
1230 (defun display-pixel-height (&optional display)
|
|
|
1231 "Return the height of DISPLAY's screen in pixels.
|
|
|
1232 For character terminals, each character counts as a single pixel."
|
|
|
1233 (device-pixel-height (display-device display)))
|
|
|
1234
|
|
|
1235 (defun display-pixel-width (&optional display)
|
|
|
1236 "Return the width of DISPLAY's screen in pixels.
|
|
|
1237 For character terminals, each character counts as a single pixel."
|
|
|
1238 (device-pixel-width (display-device display)))
|
|
|
1239
|
|
|
1240 (defun display-mm-height (&optional display)
|
|
|
1241 "Return the height of DISPLAY's screen in millimeters.
|
|
|
1242 If the information is unavailable, value is nil."
|
|
|
1243 (device-mm-height (display-device display)))
|
|
|
1244
|
|
|
1245 (defun display-mm-width (&optional display)
|
|
|
1246 "Return the width of DISPLAY's screen in millimeters.
|
|
|
1247 If the information is unavailable, value is nil."
|
|
|
1248 (device-mm-width (display-device display)))
|
|
|
1249
|
|
|
1250 (defun display-backing-store (&optional display)
|
|
|
1251 "Return the backing store capability of DISPLAY's screen.
|
|
|
1252 The value may be `always', `when-mapped', `not-useful', or nil if
|
|
|
1253 the question is inapplicable to a certain kind of display."
|
|
|
1254 (device-backing-store (display-device display)))
|
|
|
1255
|
|
|
1256 (defun display-save-under (&optional display)
|
|
|
1257 "Return non-nil if DISPLAY's screen supports the SaveUnder feature."
|
|
|
1258 (device-save-under (display-device display)))
|
|
|
1259
|
|
|
1260 (defun display-planes (&optional display)
|
|
|
1261 "Return the number of planes supported by DISPLAY."
|
|
|
1262 (device-bitplanes (display-device display)))
|
|
|
1263
|
|
|
1264 (defun display-color-cells (&optional display)
|
|
|
1265 "Return the number of color cells supported by DISPLAY."
|
|
|
1266 (device-color-cells (display-device display)))
|
|
|
1267
|
|
|
1268 (defun display-visual-class (&optional display)
|
|
|
1269 "Returns the visual class of DISPLAY.
|
|
|
1270 The value is one of the symbols `static-gray', `gray-scale',
|
|
|
1271 `static-color', `pseudo-color', `true-color', or `direct-color'."
|
|
|
1272 (case (framep-on-display display)
|
|
2367
|
1273 (x (declare-fboundp (x-display-visual-class (display-device display))))
|
|
|
1274 (gtk (declare-fboundp (gtk-display-visual-class (display-device display))))
|
|
1942
|
1275 (mswindows (let ((planes (display-planes display)))
|
|
|
1276 (cond ((eq planes 1) 'static-gray)
|
|
|
1277 ((eq planes 4) 'static-color)
|
|
|
1278 ((> planes 8) 'true-color)
|
|
|
1279 (t 'pseudo-color))))
|
|
|
1280 (t 'static-gray)))
|
|
|
1281
|
|
|
1282
|
|
|
1283 ;; XEmacs change: omit the Emacs 18 compatibility functions:
|
|
|
1284 ;; screen-height, screen-width, set-screen-height, and set-screen-width.
|
|
|
1285
|
|
|
1286 (defun delete-other-frames (&optional frame)
|
|
|
1287 "Delete all frames except FRAME.
|
|
|
1288 If FRAME uses another frame's minibuffer, the minibuffer frame is
|
|
|
1289 left untouched. FRAME nil or omitted means use the selected frame."
|
|
|
1290 (interactive)
|
|
|
1291 (unless frame
|
|
|
1292 (setq frame (selected-frame)))
|
|
|
1293 (let* ((mini-frame (window-frame (minibuffer-window frame)))
|
|
|
1294 (frames (delq mini-frame (delq frame (frame-list)))))
|
|
|
1295 (mapc 'delete-frame frames)))
|
|
|
1296
|
|
|
1297 ;; XEmacs change: we still use delete-frame-hook
|
|
|
1298 ;; miscellaneous obsolescence declarations
|
|
|
1299 ;(defvaralias 'delete-frame-hook 'delete-frame-functions)
|
|
|
1300 ;(make-obsolete-variable 'delete-frame-hook 'delete-frame-functions "21.4")
|
|
|
1301
|
|
|
1302
|
|
|
1303 ;; Highlighting trailing whitespace.
|
|
|
1304 ;; XEmacs omission: this functionality is provided by whitespace-mode in the
|
|
|
1305 ;; text-modes package.
|
|
|
1306
|
|
|
1307 ;(make-variable-buffer-local 'show-trailing-whitespace)
|
|
|
1308
|
|
|
1309 ;(defcustom show-trailing-whitespace nil
|
|
|
1310 ; "*Non-nil means highlight trailing whitespace in face `trailing-whitespace'.
|
|
|
1311 ;
|
|
|
1312 ;Setting this variable makes it local to the current buffer."
|
|
|
1313 ; :tag "Highlight trailing whitespace."
|
|
|
1314 ; :type 'boolean
|
|
|
1315 ; :group 'font-lock)
|
|
|
1316
|
|
|
1317
|
|
|
1318 ;; Scrolling
|
|
|
1319 ;; XEmacs omission: This functionality is always enabled on XEmacs.
|
|
|
1320
|
|
|
1321 ;(defgroup scrolling nil
|
|
|
1322 ; "Scrolling windows."
|
|
|
1323 ; :version "21.1"
|
|
|
1324 ; :group 'frames)
|
|
|
1325
|
|
|
1326 ;(defcustom auto-hscroll-mode t
|
|
|
1327 ; "*Allow or disallow automatic scrolling windows horizontally.
|
|
|
1328 ;If non-nil, windows are automatically scrolled horizontally to make
|
|
|
1329 ;point visible."
|
|
|
1330 ; :version "21.1"
|
|
|
1331 ; :type 'boolean
|
|
|
1332 ; :group 'scrolling)
|
|
|
1333 ;(defvaralias 'automatic-hscrolling 'auto-hscroll-mode)
|
|
|
1334
|
|
|
1335
|
|
|
1336 ;; Blinking cursor
|
|
|
1337 ;; XEmacs omission: this functionality is provided by blink-cursor in the
|
|
|
1338 ;; edit-utils package.
|
|
|
1339
|
|
|
1340 ; (defgroup cursor nil
|
|
|
1341 ; "Displaying text cursors."
|
|
|
1342 ; :version "21.1"
|
|
|
1343 ; :group 'frames)
|
|
428
|
1344
|
|
1942
|
1345 ; (defcustom blink-cursor-delay 0.5
|
|
|
1346 ; "*Seconds of idle time after which cursor starts to blink."
|
|
|
1347 ; :tag "Delay in seconds."
|
|
|
1348 ; :type 'number
|
|
|
1349 ; :group 'cursor)
|
|
|
1350
|
|
|
1351 ; (defcustom blink-cursor-interval 0.5
|
|
|
1352 ; "*Length of cursor blink interval in seconds."
|
|
|
1353 ; :tag "Blink interval in seconds."
|
|
|
1354 ; :type 'number
|
|
|
1355 ; :group 'cursor)
|
|
|
1356
|
|
|
1357 ; (defvar blink-cursor-idle-timer nil
|
|
|
1358 ; "Timer started after `blink-cursor-delay' seconds of Emacs idle time.
|
|
|
1359 ; The function `blink-cursor-start' is called when the timer fires.")
|
|
|
1360
|
|
|
1361 ; (defvar blink-cursor-timer nil
|
|
|
1362 ; "Timer started from `blink-cursor-start'.
|
|
|
1363 ; This timer calls `blink-cursor' every `blink-cursor-interval' seconds.")
|
|
|
1364
|
|
|
1365 ; (defvar blink-cursor-mode nil
|
|
|
1366 ; "Non-nil means blinking cursor is active.")
|
|
|
1367
|
|
|
1368 ; (defun blink-cursor-mode (arg)
|
|
|
1369 ; "Toggle blinking cursor mode.
|
|
|
1370 ; With a numeric argument, turn blinking cursor mode on iff ARG is positive.
|
|
|
1371 ; When blinking cursor mode is enabled, the cursor of the selected
|
|
|
1372 ; window blinks.
|
|
|
1373
|
|
|
1374 ; Note that this command is effective only when Emacs
|
|
|
1375 ; displays through a window system, because then Emacs does its own
|
|
|
1376 ; cursor display. On a text-only terminal, this is not implemented."
|
|
|
1377 ; (interactive "P")
|
|
|
1378 ; (let ((on-p (if (null arg)
|
|
|
1379 ; (not blink-cursor-mode)
|
|
|
1380 ; (> (prefix-numeric-value arg) 0))))
|
|
|
1381 ; (if blink-cursor-idle-timer
|
|
|
1382 ; (cancel-timer blink-cursor-idle-timer))
|
|
|
1383 ; (if blink-cursor-timer
|
|
|
1384 ; (cancel-timer blink-cursor-timer))
|
|
|
1385 ; (setq blink-cursor-idle-timer nil
|
|
|
1386 ; blink-cursor-timer nil
|
|
|
1387 ; blink-cursor-mode nil)
|
|
|
1388 ; (if on-p
|
|
|
1389 ; (progn
|
|
|
1390 ; ;; Hide the cursor.
|
|
|
1391 ; ;(internal-show-cursor nil nil)
|
|
|
1392 ; (setq blink-cursor-idle-timer
|
|
|
1393 ; (run-with-idle-timer blink-cursor-delay
|
|
|
1394 ; blink-cursor-delay
|
|
|
1395 ; 'blink-cursor-start))
|
|
|
1396 ; (setq blink-cursor-mode t))
|
|
|
1397 ; (internal-show-cursor nil t))))
|
|
|
1398
|
|
|
1399 ; ;; Note that this is really initialized from startup.el before
|
|
|
1400 ; ;; the init-file is read.
|
|
|
1401
|
|
|
1402 ; (defcustom blink-cursor nil
|
|
|
1403 ; "*Non-nil means blinking cursor mode is active."
|
|
|
1404 ; :group 'cursor
|
|
|
1405 ; :tag "Blinking cursor"
|
|
|
1406 ; :type 'boolean
|
|
|
1407 ; :set #'(lambda (symbol value)
|
|
|
1408 ; (set-default symbol value)
|
|
|
1409 ; (blink-cursor-mode (or value 0))))
|
|
428
|
1410
|
|
1942
|
1411 ; (defun blink-cursor-start ()
|
|
|
1412 ; "Timer function called from the timer `blink-cursor-idle-timer'.
|
|
|
1413 ; This starts the timer `blink-cursor-timer', which makes the cursor blink
|
|
|
1414 ; if appropriate. It also arranges to cancel that timer when the next
|
|
|
1415 ; command starts, by installing a pre-command hook."
|
|
|
1416 ; (when (null blink-cursor-timer)
|
|
|
1417 ; (add-hook 'pre-command-hook 'blink-cursor-end)
|
|
|
1418 ; (setq blink-cursor-timer
|
|
|
1419 ; (run-with-timer blink-cursor-interval blink-cursor-interval
|
|
|
1420 ; 'blink-cursor-timer-function))))
|
|
|
1421
|
|
|
1422 ; (defun blink-cursor-timer-function ()
|
|
|
1423 ; "Timer function of timer `blink-cursor-timer'."
|
|
|
1424 ; (internal-show-cursor nil (not (internal-show-cursor-p))))
|
|
|
1425
|
|
|
1426 ; (defun blink-cursor-end ()
|
|
|
1427 ; "Stop cursor blinking.
|
|
|
1428 ; This is installed as a pre-command hook by `blink-cursor-start'.
|
|
|
1429 ; When run, it cancels the timer `blink-cursor-timer' and removes
|
|
|
1430 ; itself as a pre-command hook."
|
|
|
1431 ; (remove-hook 'pre-command-hook 'blink-cursor-end)
|
|
|
1432 ; (internal-show-cursor nil t)
|
|
|
1433 ; (cancel-timer blink-cursor-timer)
|
|
|
1434 ; (setq blink-cursor-timer nil))
|
|
|
1435
|
|
428
|
1436
|
|
1942
|
1437 ;; Hourglass pointer
|
|
|
1438 ;; XEmacs omission: this functionality is provided elsewhere.
|
|
|
1439
|
|
|
1440 ; (defcustom display-hourglass t
|
|
|
1441 ; "*Non-nil means show an hourglass pointer when running under a window system."
|
|
|
1442 ; :tag "Hourglass pointer"
|
|
|
1443 ; :type 'boolean
|
|
|
1444 ; :group 'cursor)
|
|
|
1445
|
|
|
1446 ; (defcustom hourglass-delay 1
|
|
|
1447 ; "*Seconds to wait before displaying an hourglass pointer."
|
|
|
1448 ; :tag "Hourglass delay"
|
|
|
1449 ; :type 'number
|
|
|
1450 ; :group 'cursor)
|
|
|
1451
|
|
|
1452 ;
|
|
|
1453 ; (defcustom cursor-in-non-selected-windows t
|
|
|
1454 ; "*Non-nil means show a hollow box cursor in non-selected-windows.
|
|
|
1455 ; If nil, don't show a cursor except in the selected window.
|
|
|
1456 ; Use Custom to set this variable to get the display updated."
|
|
|
1457 ; :tag "Cursor in non-selected windows"
|
|
|
1458 ; :type 'boolean
|
|
|
1459 ; :group 'cursor
|
|
|
1460 ; :set #'(lambda (symbol value)
|
|
|
1461 ; (set-default symbol value)
|
|
|
1462 ; (force-mode-line-update t)))
|
|
|
1463
|
|
|
1464
|
|
|
1465 ;;;; Key bindings
|
|
|
1466 ;; XEmacs change: these keybindings are in keydef.el.
|
|
|
1467
|
|
|
1468 ;(define-key ctl-x-5-map "2" 'make-frame-command)
|
|
|
1469 ;(define-key ctl-x-5-map "1" 'delete-other-frames)
|
|
|
1470 ;(define-key ctl-x-5-map "0" 'delete-frame)
|
|
|
1471 ;(define-key ctl-x-5-map "o" 'other-frame)
|
|
|
1472
|
|
|
1473
|
|
|
1474 ;;; XEmacs addition: nothing below this point appears in the Emacs version.
|
|
|
1475
|
|
428
|
1476 ;;; Iconifying emacs.
|
|
|
1477 ;;;
|
|
|
1478 ;;; The function iconify-emacs replaces every non-iconified emacs window
|
|
|
1479 ;;; with a *single* icon. Iconified emacs windows are left alone. When
|
|
|
1480 ;;; emacs is in this globally-iconified state, de-iconifying any emacs icon
|
|
|
1481 ;;; will uniconify all frames that were visible, and iconify all frames
|
|
|
1482 ;;; that were not. This is done by temporarily changing the value of
|
|
|
1483 ;;; `map-frame-hook' to `deiconify-emacs' (which should never be called
|
|
|
1484 ;;; except from the map-frame-hook while emacs is iconified).
|
|
|
1485 ;;;
|
|
|
1486 ;;; The title of the icon representing all emacs frames is controlled by
|
|
|
1487 ;;; the variable `icon-name'. This is done by temporarily changing the
|
|
|
1488 ;;; value of `frame-icon-title-format'. Unfortunately, this changes the
|
|
|
1489 ;;; titles of all emacs icons, not just the "big" icon.
|
|
|
1490 ;;;
|
|
|
1491 ;;; It would be nice if existing icons were removed and restored by
|
|
|
1492 ;;; iconifying the emacs process, but I couldn't make that work yet.
|
|
|
1493
|
|
|
1494 (defvar icon-name nil) ; set this at run time, not load time.
|
|
|
1495
|
|
|
1496 (defvar iconification-data nil)
|
|
|
1497
|
|
|
1498 (defun iconify-emacs ()
|
|
|
1499 "Replace every non-iconified FRAME with a *single* icon.
|
|
|
1500 Iconified frames are left alone. When XEmacs is in this
|
|
|
1501 globally-iconified state, de-iconifying any emacs icon will uniconify
|
|
|
1502 all frames that were visible, and iconify all frames that were not."
|
|
|
1503 (interactive)
|
|
|
1504 (if iconification-data (error "already iconified?"))
|
|
|
1505 (let* ((frames (frame-list))
|
|
|
1506 (rest frames)
|
|
|
1507 (me (selected-frame))
|
|
|
1508 frame)
|
|
|
1509 (while rest
|
|
|
1510 (setq frame (car rest))
|
|
|
1511 (setcar rest (cons frame (frame-visible-p frame)))
|
|
|
1512 ; (if (memq (cdr (car rest)) '(icon nil))
|
|
|
1513 ; (progn
|
|
|
1514 ; (make-frame-visible frame) ; deiconify, and process the X event
|
|
|
1515 ; (sleep-for 500 t) ; process X events; I really want to XSync() here
|
|
|
1516 ; ))
|
|
|
1517 (or (eq frame me) (make-frame-invisible frame))
|
|
|
1518 (setq rest (cdr rest)))
|
|
|
1519 (or (boundp 'map-frame-hook) (setq map-frame-hook nil))
|
|
|
1520 (or icon-name
|
|
|
1521 (setq icon-name (concat invocation-name " @ " (system-name))))
|
|
|
1522 (setq iconification-data
|
|
|
1523 (list frame-icon-title-format map-frame-hook frames)
|
|
|
1524 frame-icon-title-format icon-name
|
|
|
1525 map-frame-hook 'deiconify-emacs)
|
|
|
1526 (iconify-frame me)))
|
|
|
1527
|
|
|
1528
|
|
|
1529 (defun deiconify-emacs (&optional ignore)
|
|
|
1530 (or iconification-data (error "not iconified?"))
|
|
|
1531 (setq frame-icon-title-format (car iconification-data)
|
|
|
1532 map-frame-hook (car (cdr iconification-data))
|
|
|
1533 iconification-data (car (cdr (cdr iconification-data))))
|
|
|
1534 (while iconification-data
|
|
|
1535 (let ((visibility (cdr (car iconification-data))))
|
|
|
1536 (cond (visibility ;; JV (Note non-nil means visible in XEmacs)
|
|
|
1537 (make-frame-visible (car (car iconification-data))))
|
|
|
1538 ; (t ;; (eq visibility 'icon) ;; JV Not in XEmacs!!!
|
|
|
1539 ; (make-frame-visible (car (car iconification-data)))
|
|
|
1540 ; (sleep-for 500 t) ; process X events; I really want to XSync() here
|
|
|
1541 ; (iconify-frame (car (car iconification-data))))
|
|
|
1542 ;; (t nil)
|
|
|
1543 ))
|
|
|
1544 (setq iconification-data (cdr iconification-data))))
|
|
|
1545
|
|
|
1546 (defun suspend-or-iconify-emacs ()
|
|
3547
|
1547 "Call iconify-emacs if using a window system, otherwise suspend.
|
|
|
1548
|
|
|
1549 `suspend' here can mean different things; if the current TTY console was
|
|
|
1550 created by gnuclient, that console is suspended, and the related devices and
|
|
|
1551 frames are removed from the display. Otherwise the Emacs process as a whole
|
|
|
1552 is suspended--that is, the traditional Unix suspend takes place. "
|
|
428
|
1553 (interactive)
|
|
|
1554 (cond ((device-on-window-system-p)
|
|
|
1555 (iconify-emacs))
|
|
|
1556 ((and (eq (device-type) 'tty)
|
|
502
|
1557 (declare-fboundp (console-tty-controlling-process
|
|
|
1558 (selected-console))))
|
|
428
|
1559 (suspend-console (selected-console)))
|
|
|
1560 (t
|
|
|
1561 (suspend-emacs))))
|
|
|
1562
|
|
|
1563 ;; This is quite a mouthful, but it should be descriptive, as it's
|
|
|
1564 ;; bound to C-z. FSF takes the easy way out by binding C-z to
|
|
|
1565 ;; different things depending on window-system. We can't do the same,
|
|
|
1566 ;; because we allow simultaneous X and TTY consoles.
|
|
|
1567 (defun suspend-emacs-or-iconify-frame ()
|
|
3547
|
1568 "Iconify the selected frame if using a window system, otherwise suspend.
|
|
|
1569
|
|
|
1570 `suspend' here can mean different things; if the current TTY console was
|
|
|
1571 created by gnuclient, the console is suspended, and the related devices and
|
|
|
1572 frames are removed from the display. Otherwise the Emacs process as a whole
|
|
|
1573 is suspended--that is, the traditional Unix suspend takes place. "
|
|
428
|
1574 (interactive)
|
|
|
1575 (cond ((device-on-window-system-p)
|
|
|
1576 (iconify-frame))
|
|
|
1577 ((and (eq (frame-type) 'tty)
|
|
502
|
1578 (declare-fboundp (console-tty-controlling-process
|
|
|
1579 (selected-console))))
|
|
428
|
1580 (suspend-console (selected-console)))
|
|
|
1581 (t
|
|
|
1582 (suspend-emacs))))
|
|
|
1583
|
|
|
1584
|
|
|
1585 ;;; Application-specific frame-management
|
|
|
1586
|
|
|
1587 (defcustom get-frame-for-buffer-default-frame-name nil
|
|
|
1588 "*The default frame to select; see doc of `get-frame-for-buffer'."
|
|
|
1589 :type 'string
|
|
|
1590 :group 'frames)
|
|
|
1591
|
|
|
1592 (defcustom get-frame-for-buffer-default-instance-limit nil
|
|
|
1593 "*The default instance limit for creating new frames;
|
|
|
1594 see doc of `get-frame-for-buffer'."
|
|
|
1595 :type 'integer
|
|
|
1596 :group 'frames)
|
|
|
1597
|
|
|
1598 (defun get-frame-name-for-buffer (buffer)
|
|
|
1599 (let ((mode (and (get-buffer buffer)
|
|
|
1600 (save-excursion (set-buffer buffer)
|
|
|
1601 major-mode))))
|
|
|
1602 (or (get mode 'frame-name)
|
|
|
1603 get-frame-for-buffer-default-frame-name)))
|
|
|
1604
|
|
|
1605 (defun get-frame-for-buffer-make-new-frame (buffer &optional frame-name plist)
|
|
|
1606 (let* ((fr (make-frame plist))
|
|
|
1607 (w (frame-root-window fr)))
|
|
|
1608 ;;
|
|
|
1609 ;; Make the one buffer being displayed in this newly created
|
|
|
1610 ;; frame be the buffer of interest, instead of something
|
|
|
1611 ;; random, so that it won't be shown in two-window mode.
|
|
|
1612 ;; Avoid calling switch-to-buffer here, since that's something
|
|
|
1613 ;; people might want to call this routine from.
|
|
|
1614 ;;
|
|
|
1615 ;; (If the root window doesn't have a buffer, then that means
|
|
|
1616 ;; there is more than one window on the frame, which can only
|
|
|
1617 ;; happen if the user has done something funny on the frame-
|
|
|
1618 ;; creation-hook. If that's the case, leave it alone.)
|
|
|
1619 ;;
|
|
|
1620 (if (window-buffer w)
|
|
|
1621 (set-window-buffer w buffer))
|
|
|
1622 fr))
|
|
|
1623
|
|
|
1624 (defcustom get-frame-for-buffer-default-to-current nil
|
|
|
1625 "*When non-nil, `get-frame-for-buffer' will default to the selected frame."
|
|
|
1626 :type 'boolean
|
|
|
1627 :group 'frames)
|
|
|
1628
|
|
|
1629 (defun get-frame-for-buffer-noselect (buffer
|
|
|
1630 &optional not-this-window-p on-frame)
|
|
|
1631 "Return a frame in which to display BUFFER.
|
|
|
1632 This is a subroutine of `get-frame-for-buffer' (which see)."
|
|
|
1633 (let (name limit)
|
|
|
1634 (cond
|
|
|
1635 ((or on-frame (eq (selected-window) (minibuffer-window)))
|
|
|
1636 ;; don't switch frames if a frame was specified, or to list
|
|
|
1637 ;; completions from the minibuffer, etc.
|
|
|
1638 nil)
|
|
|
1639
|
|
|
1640 ((setq name (get-frame-name-for-buffer buffer))
|
|
|
1641 ;;
|
|
|
1642 ;; This buffer's mode expressed a preference for a frame of a particular
|
|
|
1643 ;; name. That always takes priority.
|
|
|
1644 ;;
|
|
|
1645 (let ((limit (get name 'instance-limit))
|
|
|
1646 (defaults (get name 'frame-defaults))
|
|
|
1647 (matching-frames '())
|
|
|
1648 frames frame already-visible)
|
|
|
1649 ;; Sort the list so that iconic frames will be found last. They
|
|
|
1650 ;; will be used too, but mapped frames take precedence. And
|
|
|
1651 ;; fully visible frames come before occluded frames.
|
|
|
1652 ;; Hidden frames come after really visible ones
|
|
|
1653 (setq frames
|
|
|
1654 (sort (frame-list)
|
|
|
1655 #'(lambda (s1 s2)
|
|
|
1656 (cond ((frame-totally-visible-p s2)
|
|
|
1657 nil)
|
|
|
1658 ((not (frame-visible-p s2))
|
|
|
1659 (frame-visible-p s1))
|
|
|
1660 ((eq (frame-visible-p s2) 'hidden)
|
|
|
1661 (eq (frame-visible-p s1) t ))
|
|
|
1662 ((not (frame-totally-visible-p s2))
|
|
|
1663 (and (frame-visible-p s1)
|
|
|
1664 (frame-totally-visible-p s1)))))))
|
|
|
1665 ;; but the selected frame should come first, even if it's occluded,
|
|
|
1666 ;; to minimize thrashing.
|
|
|
1667 (setq frames (cons (selected-frame)
|
|
|
1668 (delq (selected-frame) frames)))
|
|
|
1669
|
|
|
1670 (setq name (symbol-name name))
|
|
|
1671 (while frames
|
|
|
1672 (setq frame (car frames))
|
|
|
1673 (if (equal name (frame-name frame))
|
|
|
1674 (if (get-buffer-window buffer frame)
|
|
|
1675 (setq already-visible frame
|
|
|
1676 frames nil)
|
|
|
1677 (setq matching-frames (cons frame matching-frames))))
|
|
|
1678 (setq frames (cdr frames)))
|
|
|
1679 (cond (already-visible
|
|
|
1680 already-visible)
|
|
|
1681 ((or (null matching-frames)
|
|
|
1682 (eq limit 0) ; means create with reckless abandon
|
|
|
1683 (and limit (< (length matching-frames) limit)))
|
|
|
1684 (get-frame-for-buffer-make-new-frame
|
|
|
1685 buffer
|
|
|
1686 name
|
|
|
1687 (alist-to-plist (acons 'name name
|
|
|
1688 (plist-to-alist defaults)))))
|
|
|
1689 (t
|
|
|
1690 ;; do not switch any of the window/buffer associations in an
|
|
|
1691 ;; existing frame; this function only picks a frame; the
|
|
|
1692 ;; determination of which windows on it get reused is up to
|
|
|
1693 ;; display-buffer itself.
|
|
|
1694 ;; (or (window-dedicated-p (selected-window))
|
|
|
1695 ;; (switch-to-buffer buffer))
|
|
|
1696 (car matching-frames)))))
|
|
|
1697
|
|
|
1698 ((setq limit get-frame-for-buffer-default-instance-limit)
|
|
|
1699 ;;
|
|
|
1700 ;; This buffer's mode did not express a preference for a frame of a
|
|
|
1701 ;; particular name, but the user wants a new frame rather than
|
|
|
1702 ;; reusing the existing one.
|
|
|
1703 (let* ((defname
|
|
|
1704 (or (plist-get default-frame-plist 'name)
|
|
|
1705 default-frame-name))
|
|
|
1706 (frames
|
|
|
1707 (sort (filtered-frame-list #'(lambda (x)
|
|
|
1708 (or (frame-visible-p x)
|
|
|
1709 (frame-iconified-p x))))
|
|
|
1710 #'(lambda (s1 s2)
|
|
|
1711 (cond ((and (frame-visible-p s1)
|
|
|
1712 (not (frame-visible-p s2))))
|
|
|
1713 ((and (eq (frame-visible-p s1) t)
|
|
|
1714 (eq (frame-visible-p s2) 'hidden)))
|
|
|
1715 ((and (frame-visible-p s2)
|
|
|
1716 (not (frame-visible-p s1)))
|
|
|
1717 nil)
|
|
|
1718 ((and (equal (frame-name s1) defname)
|
|
|
1719 (not (equal (frame-name s2) defname))))
|
|
|
1720 ((and (equal (frame-name s2) defname)
|
|
|
1721 (not (equal (frame-name s1) defname)))
|
|
|
1722 nil)
|
|
|
1723 ((frame-totally-visible-p s2)
|
|
|
1724 nil)
|
|
|
1725 (t))))))
|
|
|
1726 ;; put the selected frame last. The user wants a new frame,
|
|
|
1727 ;; so don't reuse the existing one unless forced to.
|
|
|
1728 (setq frames (append (delq (selected-frame) frames) (list frames)))
|
|
|
1729 (if (or (eq limit 0) ; means create with reckless abandon
|
|
|
1730 (< (length frames) limit))
|
|
|
1731 (get-frame-for-buffer-make-new-frame buffer)
|
|
|
1732 (car frames))))
|
|
|
1733
|
|
|
1734 (not-this-window-p
|
|
|
1735 (let ((w-list (windows-of-buffer buffer))
|
|
|
1736 f w
|
|
|
1737 (first-choice nil)
|
|
|
1738 (second-choice (if get-frame-for-buffer-default-to-current
|
|
|
1739 (selected-frame)
|
|
|
1740 nil))
|
|
|
1741 (last-resort nil))
|
|
|
1742 (while (and w-list (null first-choice))
|
|
|
1743 (setq w (car w-list)
|
|
|
1744 f (window-frame w))
|
|
|
1745 (cond ((eq w (selected-window)) nil)
|
|
|
1746 ((not (frame-visible-p f))
|
|
|
1747 (if (null last-resort)
|
|
|
1748 (setq last-resort f)))
|
|
|
1749 ((eq f (selected-frame))
|
|
|
1750 (setq first-choice f))
|
|
|
1751 ((null second-choice)
|
|
|
1752 (setq second-choice f)))
|
|
|
1753 (setq w-list (cdr w-list)))
|
|
|
1754 (or first-choice second-choice last-resort)))
|
|
|
1755
|
|
|
1756 (get-frame-for-buffer-default-to-current (selected-frame))
|
|
|
1757
|
|
|
1758 (t
|
|
|
1759 ;;
|
|
|
1760 ;; This buffer's mode did not express a preference for a frame of a
|
|
|
1761 ;; particular name. So try to find a frame already displaying this
|
|
|
1762 ;; buffer.
|
|
|
1763 ;;
|
|
|
1764 (let ((w (or (get-buffer-window buffer nil) ; check current first
|
|
|
1765 (get-buffer-window buffer 'visible) ; then visible
|
|
|
1766 (get-buffer-window buffer 0)))) ; then iconic
|
|
|
1767 (cond ((null w)
|
|
|
1768 ;; It's not in any window - return nil, meaning no frame has
|
|
|
1769 ;; preference.
|
|
|
1770 nil)
|
|
|
1771 (t
|
|
|
1772 ;; Otherwise, return the frame of the buffer's window.
|
|
|
1773 (window-frame w))))))))
|
|
|
1774
|
|
|
1775
|
|
|
1776 ;; The pre-display-buffer-function is called for effect, so this needs to
|
|
|
1777 ;; actually select the frame it wants. Fdisplay_buffer() takes notice of
|
|
|
1778 ;; changes to the selected frame.
|
|
903
|
1779 (defun get-frame-for-buffer (buffer &optional not-this-window-p on-frame
|
|
|
1780 shrink-to-fit)
|
|
428
|
1781 "Select and return a frame in which to display BUFFER.
|
|
|
1782 Normally, the buffer will simply be displayed in the selected frame.
|
|
3061
|
1783 But if the symbol naming the major-mode of the buffer has a `frame-name'
|
|
428
|
1784 property (which should be a symbol), then the buffer will be displayed in
|
|
|
1785 a frame of that name. If there is no frame of that name, then one is
|
|
|
1786 created.
|
|
|
1787
|
|
3061
|
1788 If the major-mode doesn't have a `frame-name' property, then the frame
|
|
428
|
1789 named by `get-frame-for-buffer-default-frame-name' will be used. If
|
|
|
1790 that is nil (the default) then the currently selected frame will used.
|
|
|
1791
|
|
3061
|
1792 If the frame-name symbol has an `instance-limit' property (an integer)
|
|
428
|
1793 then each time a buffer of the mode in question is displayed, a new frame
|
|
|
1794 with that name will be created, until there are `instance-limit' of them.
|
|
|
1795 If instance-limit is 0, then a new frame will be created each time.
|
|
|
1796
|
|
|
1797 If a buffer is already displayed in a frame, then `instance-limit' is
|
|
|
1798 ignored, and that frame is used.
|
|
|
1799
|
|
3061
|
1800 If the frame-name symbol has a `frame-defaults' property, then that is
|
|
428
|
1801 prepended to the `default-frame-plist' when creating a frame for the
|
|
|
1802 first time.
|
|
|
1803
|
|
|
1804 This function may be used as the value of `pre-display-buffer-function',
|
|
444
|
1805 to cause the `display-buffer' function and its callers to exhibit the
|
|
|
1806 above behavior."
|
|
428
|
1807 (let ((frame (get-frame-for-buffer-noselect
|
|
|
1808 buffer not-this-window-p on-frame)))
|
|
|
1809 (if (not (eq frame (selected-frame)))
|
|
|
1810 frame
|
|
|
1811 (select-frame frame)
|
|
|
1812 (or (frame-visible-p frame)
|
|
|
1813 ;; If the frame was already visible, just focus on it.
|
|
|
1814 ;; If it wasn't visible (it was just created, or it used
|
|
|
1815 ;; to be iconified) then uniconify, raise, etc.
|
|
|
1816 (make-frame-visible frame))
|
|
|
1817 frame)))
|
|
|
1818
|
|
|
1819 (defun frames-of-buffer (&optional buffer visible-only)
|
|
|
1820 "Return list of frames that BUFFER is currently being displayed on.
|
|
|
1821 If the buffer is being displayed on the currently selected frame, that frame
|
|
|
1822 is first in the list. VISIBLE-ONLY will only list non-iconified frames."
|
|
|
1823 (let ((list (windows-of-buffer buffer))
|
|
|
1824 (cur-frame (selected-frame))
|
|
|
1825 next-frame frames save-frame)
|
|
|
1826
|
|
|
1827 (while list
|
|
|
1828 (if (memq (setq next-frame (window-frame (car list)))
|
|
|
1829 frames)
|
|
|
1830 nil
|
|
|
1831 (if (eq cur-frame next-frame)
|
|
|
1832 (setq save-frame next-frame)
|
|
|
1833 (and
|
|
|
1834 (or (not visible-only)
|
|
|
1835 (frame-visible-p next-frame))
|
|
|
1836 (setq frames (append frames (list next-frame))))))
|
|
|
1837 (setq list (cdr list)))
|
|
|
1838
|
|
|
1839 (if save-frame
|
|
|
1840 (append (list save-frame) frames)
|
|
|
1841 frames)))
|
|
|
1842
|
|
|
1843 (defcustom temp-buffer-shrink-to-fit nil
|
|
|
1844 "*When non-nil resize temporary output buffers to minimize blank lines."
|
|
|
1845 :type 'boolean
|
|
|
1846 :group 'frames)
|
|
|
1847
|
|
|
1848 (defcustom temp-buffer-max-height .5
|
|
|
1849 "*Proportion of frame to use for temp windows."
|
|
|
1850 :type 'number
|
|
|
1851 :group 'frames)
|
|
|
1852
|
|
|
1853 (defun show-temp-buffer-in-current-frame (buffer)
|
|
444
|
1854 "For use as the value of `temp-buffer-show-function':
|
|
428
|
1855 always displays the buffer in the selected frame, regardless of the behavior
|
|
|
1856 that would otherwise be introduced by the `pre-display-buffer-function', which
|
|
|
1857 is normally set to `get-frame-for-buffer' (which see)."
|
|
|
1858 (let ((pre-display-buffer-function nil)) ; turn it off, whatever it is
|
|
903
|
1859 (let ((window (display-buffer buffer nil nil temp-buffer-shrink-to-fit)))
|
|
428
|
1860 (if (not (eq (last-nonminibuf-frame) (window-frame window)))
|
|
|
1861 ;; only the pre-display-buffer-function should ever do this.
|
|
|
1862 (error "display-buffer switched frames on its own!!"))
|
|
|
1863 (setq minibuffer-scroll-window window)
|
|
|
1864 (set-window-start window 1) ; obeys narrowing
|
|
|
1865 (set-window-point window 1)
|
|
|
1866 nil)))
|
|
|
1867
|
|
|
1868 (setq pre-display-buffer-function 'get-frame-for-buffer)
|
|
|
1869 (setq temp-buffer-show-function 'show-temp-buffer-in-current-frame)
|
|
|
1870
|
|
|
1871
|
|
|
1872 ;; from Bob Weiner <bweiner@pts.mot.com>, modified by Ben Wing
|
|
|
1873
|
|
|
1874 ;; By adding primitives to directly access the window hierarchy,
|
|
|
1875 ;; we can move many functions into Lisp. We do it this way
|
|
|
1876 ;; because the implementations are simpler in Lisp, and because
|
|
|
1877 ;; new functions like this can be added without requiring C
|
|
|
1878 ;; additions.
|
|
|
1879
|
|
|
1880 (defun frame-utmost-window-2 (window position left-right-p major-end-p
|
|
|
1881 minor-end-p)
|
|
|
1882 ;; LEFT-RIGHT-P means we're looking for the leftmost or rightmost
|
|
|
1883 ;; window, instead of the highest or lowest. In this case, we
|
|
|
1884 ;; say that the "major axis" goes left-to-right instead of top-to-
|
|
|
1885 ;; bottom. The "minor axis" always goes perpendicularly.
|
|
|
1886 ;;
|
|
|
1887 ;; If MAJOR-END-P is t, we're looking for a windows that abut the
|
|
|
1888 ;; end (i.e. right or bottom) of the major axis, instead of the
|
|
|
1889 ;; start.
|
|
|
1890 ;;
|
|
|
1891 ;; If MINOR-END-P is t, then we want to start counting from the
|
|
|
1892 ;; end of the minor axis instead of the beginning.
|
|
|
1893 ;;
|
|
|
1894 ;; Here's the general idea: Imagine we're trying to count the number
|
|
|
1895 ;; of windows that abut the top; call this function foo(). So, we
|
|
|
1896 ;; start with the root window. If this is a vertical combination
|
|
|
1897 ;; window, then foo() applied to the root window is the same as
|
|
|
1898 ;; foo() applied to the first child. If the root is a horizontal
|
|
|
1899 ;; combination window, then foo() applied to the root is the
|
|
|
1900 ;; same as the sum of foo() applied to each of the children.
|
|
|
1901 ;; Otherwise, the root window is a leaf window, and foo() is 1.
|
|
|
1902 ;; Now it's clear that, each time foo() encounters a leaf window,
|
|
|
1903 ;; it's encountering a different window that abuts the top.
|
|
|
1904 ;; With a little examining, you can see that foo encounters the
|
|
|
1905 ;; top-abutting windows in order from left to right. We can
|
|
|
1906 ;; modify foo() to return the nth top-abutting window by simply
|
|
|
1907 ;; keeping a global variable that is decremented each time
|
|
|
1908 ;; foo() encounters a leaf window and would return 1. If the
|
|
|
1909 ;; global counter gets to zero, we've encountered the window
|
|
|
1910 ;; we were looking for, so we exit right away using a `throw'.
|
|
|
1911 ;; Otherwise, we make sure that all normal paths return nil.
|
|
|
1912
|
|
|
1913 (let (child)
|
|
|
1914 (cond ((setq child (if left-right-p
|
|
|
1915 (window-first-hchild window)
|
|
|
1916 (window-first-vchild window)))
|
|
|
1917 (if major-end-p
|
|
|
1918 (while (window-next-child child)
|
|
|
1919 (setq child (window-next-child child))))
|
|
|
1920 (frame-utmost-window-2 child position left-right-p major-end-p
|
|
|
1921 minor-end-p))
|
|
|
1922 ((setq child (if left-right-p
|
|
|
1923 (window-first-vchild window)
|
|
|
1924 (window-first-hchild window)))
|
|
|
1925 (if minor-end-p
|
|
|
1926 (while (window-next-child child)
|
|
|
1927 (setq child (window-next-child child))))
|
|
|
1928 (while child
|
|
|
1929 (frame-utmost-window-2 child position left-right-p major-end-p
|
|
|
1930 minor-end-p)
|
|
|
1931 (setq child (if minor-end-p
|
|
|
1932 (window-previous-child child)
|
|
|
1933 (window-next-child child))))
|
|
|
1934 nil)
|
|
|
1935 (t
|
|
|
1936 (setcar position (1- (car position)))
|
|
|
1937 (if (= (car position) 0)
|
|
|
1938 (throw 'fhw-exit window)
|
|
|
1939 nil)))))
|
|
|
1940
|
|
|
1941 (defun frame-utmost-window-1 (frame position left-right-p major-end-p)
|
|
|
1942 (let (minor-end-p)
|
|
|
1943 (or frame (setq frame (selected-frame)))
|
|
|
1944 (or position (setq position 0))
|
|
|
1945 (if (>= position 0)
|
|
|
1946 (setq position (1+ position))
|
|
|
1947 (setq minor-end-p t)
|
|
|
1948 (setq position (- position)))
|
|
|
1949 (catch 'fhw-exit
|
|
|
1950 ;; we use a cons here as a simple form of call-by-reference.
|
|
|
1951 ;; scheme has "boxes" for the same purpose.
|
|
|
1952 (frame-utmost-window-2 (frame-root-window frame) (list position)
|
|
|
1953 left-right-p major-end-p minor-end-p))))
|
|
|
1954
|
|
|
1955
|
|
|
1956 (defun frame-highest-window (&optional frame position)
|
|
|
1957 "Return the highest window on FRAME which is at POSITION.
|
|
|
1958 If omitted, FRAME defaults to the currently selected frame.
|
|
|
1959 POSITION is used to distinguish between multiple windows that abut
|
|
|
1960 the top of the frame: 0 means the leftmost window abutting the
|
|
|
1961 top of the frame, 1 the next-leftmost, etc. POSITION can also
|
|
|
1962 be less than zero: -1 means the rightmost window abutting the
|
|
|
1963 top of the frame, -2 the next-rightmost, etc.
|
|
|
1964 If omitted, POSITION defaults to 0, i.e. the leftmost highest window.
|
|
|
1965 If there is no window at the given POSITION, return nil."
|
|
|
1966 (frame-utmost-window-1 frame position nil nil))
|
|
|
1967
|
|
|
1968 (defun frame-lowest-window (&optional frame position)
|
|
|
1969 "Return the lowest window on FRAME which is at POSITION.
|
|
|
1970 If omitted, FRAME defaults to the currently selected frame.
|
|
|
1971 POSITION is used to distinguish between multiple windows that abut
|
|
|
1972 the bottom of the frame: 0 means the leftmost window abutting the
|
|
|
1973 bottom of the frame, 1 the next-leftmost, etc. POSITION can also
|
|
|
1974 be less than zero: -1 means the rightmost window abutting the
|
|
|
1975 bottom of the frame, -2 the next-rightmost, etc.
|
|
|
1976 If omitted, POSITION defaults to 0, i.e. the leftmost lowest window.
|
|
|
1977 If there is no window at the given POSITION, return nil."
|
|
|
1978 (frame-utmost-window-1 frame position nil t))
|
|
|
1979
|
|
|
1980 (defun frame-leftmost-window (&optional frame position)
|
|
|
1981 "Return the leftmost window on FRAME which is at POSITION.
|
|
|
1982 If omitted, FRAME defaults to the currently selected frame.
|
|
|
1983 POSITION is used to distinguish between multiple windows that abut
|
|
|
1984 the left edge of the frame: 0 means the highest window abutting the
|
|
|
1985 left edge of the frame, 1 the next-highest, etc. POSITION can also
|
|
|
1986 be less than zero: -1 means the lowest window abutting the
|
|
|
1987 left edge of the frame, -2 the next-lowest, etc.
|
|
|
1988 If omitted, POSITION defaults to 0, i.e. the highest leftmost window.
|
|
|
1989 If there is no window at the given POSITION, return nil."
|
|
|
1990 (frame-utmost-window-1 frame position t nil))
|
|
|
1991
|
|
|
1992 (defun frame-rightmost-window (&optional frame position)
|
|
|
1993 "Return the rightmost window on FRAME which is at POSITION.
|
|
|
1994 If omitted, FRAME defaults to the currently selected frame.
|
|
|
1995 POSITION is used to distinguish between multiple windows that abut
|
|
|
1996 the right edge of the frame: 0 means the highest window abutting the
|
|
|
1997 right edge of the frame, 1 the next-highest, etc. POSITION can also
|
|
|
1998 be less than zero: -1 means the lowest window abutting the
|
|
|
1999 right edge of the frame, -2 the next-lowest, etc.
|
|
|
2000 If omitted, POSITION defaults to 0, i.e. the highest rightmost window.
|
|
|
2001 If there is no window at the given POSITION, return nil."
|
|
|
2002 (frame-utmost-window-1 frame position t t))
|
|
|
2003
|
|
|
2004
|
|
|
2005
|
|
|
2006 ;; frame properties.
|
|
|
2007
|
|
|
2008 (put 'cursor-color 'frame-property-alias [text-cursor background])
|
|
|
2009 (put 'modeline 'frame-property-alias 'has-modeline-p)
|
|
|
2010
|
|
|
2011
|
|
|
2012 (provide 'frame)
|
|
|
2013
|
|
|
2014 ;;; frame.el ends here
|
