997 |
window object that the mouse is in; others require explicit clicks or |
window object that the mouse is in; others require explicit clicks or |
998 |
commands to @dfn{shift the focus} to various window objects. Either |
commands to @dfn{shift the focus} to various window objects. Either |
999 |
way, Emacs automatically keeps track of which frame has the focus. To |
way, Emacs automatically keeps track of which frame has the focus. To |
1000 |
switch to a different frame from a lisp function, call |
switch to a different frame from a Lisp function, call |
1001 |
@code{select-frame-set-input-focus}. |
@code{select-frame-set-input-focus}. |
1002 |
|
|
1003 |
Lisp programs can also switch frames ``temporarily'' by calling the |
Lisp programs can also switch frames ``temporarily'' by calling the |
1006 |
until that control is somehow reasserted. |
until that control is somehow reasserted. |
1007 |
|
|
1008 |
When using a text-only terminal, only one frame can be displayed at a |
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 |
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 |
redisplay actually displays the newly selected frame. This frame |
1011 |
call to @code{select-frame} or @code{select-frame-set-input-focus}. |
remains selected until a subsequent call to @code{select-frame} or |
1012 |
Each terminal frame has a number which appears in the mode line before |
@code{select-frame-set-input-focus}. Each terminal frame has a number |
1013 |
the buffer name (@pxref{Mode Line Variables}). |
which appears in the mode line before the buffer name (@pxref{Mode |
1014 |
|
Line Variables}). |
1015 |
|
|
1016 |
@defun select-frame-set-input-focus frame |
@defun select-frame-set-input-focus frame |
1017 |
This function makes @var{frame} the selected frame, raises it (should |
This function makes @var{frame} the selected frame, raises it (should |
1018 |
it happen to be obscured by other frames) and tries to give it the X |
it happen to be obscured by other frames) and tries to give it the X |
1019 |
server's focus. On a text-only terminal, the new frame gets displayed |
server's focus. On a text-only terminal, the next redisplay displays |
1020 |
on the entire terminal screen. |
the new frame on the entire terminal screen. The return value of this |
1021 |
|
function is not significant. |
1022 |
@end defun |
@end defun |
1023 |
|
|
1024 |
@c ??? This is not yet implemented properly. |
@c ??? This is not yet implemented properly. |
1028 |
the next time the user does something to select a different frame, or |
the next time the user does something to select a different frame, or |
1029 |
until the next time this function is called. The specified @var{frame} |
until the next time this function is called. The specified @var{frame} |
1030 |
becomes the selected frame, as explained above, and the terminal that |
becomes the selected frame, as explained above, and the terminal that |
1031 |
@var{frame} is on becomes the selected terminal. |
@var{frame} is on becomes the selected terminal. This function |
1032 |
|
returns @var{frame}, or @code{nil} if @var{frame} has been deleted. |
1033 |
|
|
1034 |
In general, you should never use @code{select-frame} in a way that could |
In general, you should never use @code{select-frame} in a way that could |
1035 |
switch to a different terminal without switching back when you're done. |
switch to a different terminal without switching back when you're done. |