Mercurial > emacs
comparison lispref/frames.texi @ 56371:48a83b7f435a
(Input Focus): Clarify descriptions of `select-frame-set-input-focus'
and `select-frame'.
author | Luc Teirlinck <teirllm@auburn.edu> |
---|---|
date | Wed, 07 Jul 2004 22:41:53 +0000 |
parents | b281f2cb7724 |
children | dcdd02599cbd |
comparison
equal
deleted
inserted
replaced
56370:dce4aada3bd3 | 56371:48a83b7f435a |
---|---|
1004 function @code{select-frame}. This does not alter the window system's | 1004 function @code{select-frame}. This does not alter the window system's |
1005 concept of focus; rather, it escapes from the window manager's control | 1005 concept of focus; rather, it escapes from the window manager's control |
1006 until that control is somehow reasserted. | 1006 until that control is somehow reasserted. |
1007 | 1007 |
1008 When using a text-only terminal, only one frame can be displayed at a | 1008 When using a text-only terminal, only one frame can be displayed at a |
1009 time on the terminal, so @code{select-frame} actually displays the | 1009 time on the terminal, so after a call to @code{select-frame}, the next |
1010 newly selected frame. This frame remains displayed until a subsequent | 1010 redisplay actually displays the newly selected frame. This frame |
1011 call to @code{select-frame} or @code{select-frame-set-input-focus}. | 1011 remains displayed until a subsequent call to @code{select-frame} or |
1012 Each terminal frame has a number which appears in the mode line before | 1012 @code{select-frame-set-input-focus}. Each terminal frame has a number |
1013 the buffer name (@pxref{Mode Line Variables}). | 1013 which appears in the mode line before the buffer name (@pxref{Mode |
1014 Line Variables}). | |
1014 | 1015 |
1015 @defun select-frame-set-input-focus frame | 1016 @defun select-frame-set-input-focus frame |
1016 This function makes @var{frame} the selected frame, raises it (should | 1017 This function makes @var{frame} the selected frame, raises it (should |
1017 it happen to be obscured by other frames) and tries to give it the X | 1018 it happen to be obscured by other frames) and tries to give it the X |
1018 server's focus. On a text-only terminal, the new frame gets displayed | 1019 server's focus. On a text-only terminal, the next redisplay displays |
1019 on the entire terminal screen. | 1020 the new frame on the entire terminal screen. The return value of this |
1021 function is not significant. | |
1020 @end defun | 1022 @end defun |
1021 | 1023 |
1022 @c ??? This is not yet implemented properly. | 1024 @c ??? This is not yet implemented properly. |
1023 @defun select-frame frame | 1025 @defun select-frame frame |
1024 This function selects frame @var{frame}, temporarily disregarding the | 1026 This function selects frame @var{frame}, temporarily disregarding the |
1025 focus of the X server if any. The selection of @var{frame} lasts until | 1027 focus of the X server if any. The selection of @var{frame} lasts until |
1026 the next time the user does something to select a different frame, or | 1028 the next time the user does something to select a different frame, or |
1027 until the next time this function is called. The specified @var{frame} | 1029 until the next time this function is called. The specified @var{frame} |
1028 becomes the selected frame, as explained above, and the terminal that | 1030 becomes the selected frame, as explained above, and the terminal that |
1029 @var{frame} is on becomes the selected terminal. | 1031 @var{frame} is on becomes the selected terminal. This function |
1032 returns @var{frame}, or @code{nil} if @var{frame} has been deleted. | |
1030 | 1033 |
1031 In general, you should never use @code{select-frame} in a way that could | 1034 In general, you should never use @code{select-frame} in a way that could |
1032 switch to a different terminal without switching back when you're done. | 1035 switch to a different terminal without switching back when you're done. |
1033 @end defun | 1036 @end defun |
1034 | 1037 |