Mercurial > hg > xemacs-beta

comparison man/lispref/frames.texi @ 290:c9fe270a4101 r21-0b43

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-0b43
author cvs
date Mon, 13 Aug 2007 10:36:47 +0200
parents e11d67e05968
children 2f8bb876ab1d
comparison
equal deleted inserted replaced
289:6e6992ccc4b6 290:c9fe270a4101
137 137
138 If these settings affect the frame geometry and appearance, you'll see 138 If these settings affect the frame geometry and appearance, you'll see
139 the frame appear with the wrong ones and then change to the specified 139 the frame appear with the wrong ones and then change to the specified
140 ones. If that bothers you, you can specify the same geometry and 140 ones. If that bothers you, you can specify the same geometry and
141 appearance with X resources; those do take affect before the frame is 141 appearance with X resources; those do take affect before the frame is
142 created. @xref{Resources X,, X Resources, emacs, The XEmacs User's Manual}. 142 created. @xref{Resources X,, X Resources, xemacs, The XEmacs User's Manual}.
143 143
144 X resource settings typically apply to all frames. If you want to 144 X resource settings typically apply to all frames. If you want to
145 specify some X resources solely for the sake of the initial frame, and 145 specify some X resources solely for the sake of the initial frame, and
146 you don't want them to apply to subsequent frames, here's how to achieve 146 you don't want them to apply to subsequent frames, here's how to achieve
147 this: specify properties in @code{default-frame-plist} to override the X 147 this: specify properties in @code{default-frame-plist} to override the X
168 See also @code{special-display-frame-plist}, in @ref{Choosing Window}. 168 See also @code{special-display-frame-plist}, in @ref{Choosing Window}.
169 169
170 If you use options that specify window appearance when you invoke XEmacs, 170 If you use options that specify window appearance when you invoke XEmacs,
171 they take effect by adding elements to @code{default-frame-plist}. One 171 they take effect by adding elements to @code{default-frame-plist}. One
172 exception is @samp{-geometry}, which adds the specified position to 172 exception is @samp{-geometry}, which adds the specified position to
173 @code{initial-frame-plist} instead. @xref{Command Arguments,,, emacs, 173 @code{initial-frame-plist} instead. @xref{Command Arguments,,, xemacs,
174 The XEmacs User's Manual}. 174 The XEmacs User's Manual}.
175 175
176 @node X Frame Properties 176 @node X Frame Properties
177 @subsection X Window Frame Properties 177 @subsection X Window Frame Properties
178 178
668 @defun select-frame frame 668 @defun select-frame frame
669 This function selects frame @var{frame}, temporarily disregarding the 669 This function selects frame @var{frame}, temporarily disregarding the
670 focus of the X server if any. The selection of @var{frame} lasts until 670 focus of the X server if any. The selection of @var{frame} lasts until
671 the next time the user does something to select a different frame, or 671 the next time the user does something to select a different frame, or
672 until the next time this function is called. 672 until the next time this function is called.
673 @end defun 673
674 674 Note that @code{select-frame} does not actually cause the window-system
675 Note that this does not actually cause the window-system focus to be set 675 focus to be set to this frame, or the @code{select-frame-hook} or
676 to this frame, or the @code{select-frame-hook} or
677 @code{deselect-frame-hook} to be run, until the next time that XEmacs is 676 @code{deselect-frame-hook} to be run, until the next time that XEmacs is
678 waiting for an event. 677 waiting for an event.
679 678
680 Also note that when the variable @code{focus-follows-mouse} is non-nil, 679 Also note that when the variable @code{focus-follows-mouse} is
681 the frame selection is temporary and is reverted when the current 680 non-@code{nil}, the frame selection is temporary and is reverted when
682 command terminates, much like the buffer selected by @code{set-buffer}. 681 the current command terminates, much like the buffer selected by
683 In order to effect a permanent focus change use @code{focus-frame}. 682 @code{set-buffer}. In order to effect a permanent focus change use
684 683 @code{focus-frame}.
685 @ignore (FSF Emacs) 684 @end defun
685
686 @defun focus-frame frame
687 This function selects @var{frame} and gives it the window system focus.
688 The operation of @code{focus-frame} is not affected by the value of
689 @code{focus-follows-mouse}.
690 @end defun
691
692 @defmac save-selected-frame forms@dots{}
693 This macro records the selected frame, executes @var{forms} in sequence,
694 then restores the earlier selected frame. The value returned is the
695 value of the last form.
696 @end defmac
697
698 @defmac with-selected-frame frame forms@dots{}
699 This macro records the selected frame, then selects @var{frame} and
700 executes @var{forms} in sequence. After the last form is finished, the
701 earlier selected frame is restored. The value returned is the value of
702 the last form.
703 @end defmac
704
705 @ignore (FSF Emacs, continued from defun select-frame)
686 XEmacs cooperates with the X server and the window managers by arranging 706 XEmacs cooperates with the X server and the window managers by arranging
687 to select frames according to what the server and window manager ask 707 to select frames according to what the server and window manager ask
688 for. It does so by generating a special kind of input event, called a 708 for. It does so by generating a special kind of input event, called a
689 @dfn{focus} event. The command loop handles a focus event by calling 709 @dfn{focus} event. The command loop handles a focus event by calling
690 @code{handle-select-frame}. @xref{Focus Events}. 710 @code{handle-select-frame}. @xref{Focus Events}.