/[emacs]/emacs/lispref/frames.texi
ViewVC logotype

Diff of /emacs/lispref/frames.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.65.6.3 by miles, Tue Jul 6 02:56:30 2004 UTC revision 1.65.6.4 by miles, Sun Jul 11 22:07:58 2004 UTC
# Line 997  Some window systems and window managers Line 997  Some window systems and window managers
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
# Line 1006  concept of focus; rather, it escapes fro Line 1006  concept of focus; rather, it escapes fro
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.
# Line 1026  focus of the X server if any.  The selec Line 1028  focus of the X server if any.  The selec
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.

Legend:
Removed from v.1.65.6.3  
changed lines
  Added in v.1.65.6.4

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26