Mercurial > emacs
comparison lispref/frames.texi @ 13155:0b8e0559dcee
Fix several minor errors.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Sun, 08 Oct 1995 19:38:02 +0000 |
parents | d97688032b10 |
children | 5a3beebafdcb |
comparison
equal
deleted
inserted
replaced
13154:f86e18ff3736 | 13155:0b8e0559dcee |
---|---|
5 @setfilename ../info/frames | 5 @setfilename ../info/frames |
6 @node Frames, Positions, Windows, Top | 6 @node Frames, Positions, Windows, Top |
7 @chapter Frames | 7 @chapter Frames |
8 @cindex frame | 8 @cindex frame |
9 | 9 |
10 A @var{frame} is a rectangle on the screen that contains one or more | 10 A @dfn{frame} is a rectangle on the screen that contains one or more |
11 Emacs windows. A frame initially contains a single main window (plus | 11 Emacs windows. A frame initially contains a single main window (plus |
12 perhaps a minibuffer window), which you can subdivide vertically or | 12 perhaps a minibuffer window), which you can subdivide vertically or |
13 horizontally into smaller windows. | 13 horizontally into smaller windows. |
14 | 14 |
15 @cindex terminal frame | 15 @cindex terminal frame |
59 @node Creating Frames | 59 @node Creating Frames |
60 @section Creating Frames | 60 @section Creating Frames |
61 | 61 |
62 To create a new frame, call the function @code{make-frame}. | 62 To create a new frame, call the function @code{make-frame}. |
63 | 63 |
64 @defun make-frame alist | 64 @defun make-frame &optional alist |
65 This function creates a new frame. If you are using X, it makes | 65 This function creates a new frame. If you are using X, it makes |
66 an X window frame; otherwise, it makes a terminal frame. | 66 an X window frame; otherwise, it makes a terminal frame. |
67 | 67 |
68 The argument is an alist specifying frame parameters. Any parameters | 68 The argument is an alist specifying frame parameters. Any parameters |
69 not mentioned in @var{alist} default according to the value of the | 69 not mentioned in @var{alist} default according to the value of the |
311 | 311 |
312 @item user-position | 312 @item user-position |
313 Non-@code{nil} if the screen position of the frame was explicitly | 313 Non-@code{nil} if the screen position of the frame was explicitly |
314 requested by the user (for example, with the @samp{-geometry} option). | 314 requested by the user (for example, with the @samp{-geometry} option). |
315 Nothing automatically makes this parameter non-@code{nil}; it is up to | 315 Nothing automatically makes this parameter non-@code{nil}; it is up to |
316 Lisp programs that call @code{make-frame} to specify this parameter as | 316 Lisp programs that call @code{make-frame} to specify this parameter to |
317 well as specifying the @code{left} and @code{top} parameters. | 317 indicate that the values of the @code{left} and @code{top} parameters |
318 are user-specified positions. | |
318 | 319 |
319 @item height | 320 @item height |
320 The height of the frame contents, in characters. (To get the height in | 321 The height of the frame contents, in characters. (To get the height in |
321 pixels, call @code{frame-pixel-height}; see @ref{Size and Position}.) | 322 pixels, call @code{frame-pixel-height}; see @ref{Size and Position}.) |
322 | 323 |
737 | 738 |
738 Emacs cooperates with the X server and the window managers by arranging | 739 Emacs cooperates with the X server and the window managers by arranging |
739 to select frames according to what the server and window manager ask | 740 to select frames according to what the server and window manager ask |
740 for. It does so by generating a special kind of input event, called a | 741 for. It does so by generating a special kind of input event, called a |
741 @dfn{focus} event. The command loop handles a focus event by calling | 742 @dfn{focus} event. The command loop handles a focus event by calling |
742 @code{handle-select-frame}. @xref{Focus Events}. | 743 @code{handle-switch-frame}. @xref{Focus Events}. |
743 | 744 |
744 @deffn Command handle-switch-frame frame | 745 @deffn Command handle-switch-frame frame |
745 This function handles a focus event by selecting frame @var{frame}. | 746 This function handles a focus event by selecting frame @var{frame}. |
746 | 747 |
747 Focus events normally do their job by invoking this command. | 748 Focus events normally do their job by invoking this command. |
1251 @xref{Resources X,, X Resources, emacs, The GNU Emacs Manual}. | 1252 @xref{Resources X,, X Resources, emacs, The GNU Emacs Manual}. |
1252 | 1253 |
1253 @node Server Data | 1254 @node Server Data |
1254 @section Data about the X Server | 1255 @section Data about the X Server |
1255 | 1256 |
1256 This section describes functions and a variable that you can use to | 1257 This section describes functions you can use to get information about |
1257 get information about the capabilities and origin of an X display that | 1258 the capabilities and origin of an X display that Emacs is using. Each |
1258 Emacs is using. Each of these functions lets you specify the display | 1259 of these functions lets you specify the display you are interested in: |
1259 you are interested in: the @var{display} argument can be either a | 1260 the @var{display} argument can be either a display name, or a frame |
1260 display name, or a frame (meaning use the display that frame is on). If | 1261 (meaning use the display that frame is on). If you omit the |
1261 you omit the @var{display} argument, or specify @code{nil}, that means | 1262 @var{display} argument, or specify @code{nil}, that means to use the |
1262 to use the selected frame's display. | 1263 selected frame's display. |
1263 | 1264 |
1264 @defun x-display-screens &optional display | 1265 @defun x-display-screens &optional display |
1265 This function returns the number of screens associated with the display. | 1266 This function returns the number of screens associated with the display. |
1266 @end defun | 1267 @end defun |
1267 | 1268 |