Commit bd998259 authored by Richard M. Stallman's avatar Richard M. Stallman
Browse files

*** empty log message ***

parent ca0ecbf5
...@@ -42,6 +42,7 @@ This predicate returns @code{t} if @var{object} is a frame, and ...@@ -42,6 +42,7 @@ This predicate returns @code{t} if @var{object} is a frame, and
* Mouse Position:: Asking where the mouse is, or moving it. * Mouse Position:: Asking where the mouse is, or moving it.
* Pop-Up Menus:: Displaying a menu for the user to select from. * Pop-Up Menus:: Displaying a menu for the user to select from.
* Dialog Boxes:: Displaying a box to ask yes or no. * Dialog Boxes:: Displaying a box to ask yes or no.
* Pointer Shapes:: Specifying the shape of the mouse pointer.
* X Selections:: Transferring text to and from other X clients. * X Selections:: Transferring text to and from other X clients.
* X Connections:: Opening and closing the X server connection. * X Connections:: Opening and closing the X server connection.
* Resources:: Getting resource values from the server. * Resources:: Getting resource values from the server.
...@@ -77,12 +78,26 @@ Each element has the form: ...@@ -77,12 +78,26 @@ Each element has the form:
@example @example
(@var{parameter} . @var{value}) (@var{parameter} . @var{value})
@end example @end example
@end defvar
If you use options that specify window appearance when you invoke Emacs, @defvar initial-frame-alist
they take effect by adding elements to @code{default-frame-alist}. This is an alist specifying frame parameters for the initial Emacs frame.
@xref{Command Arguments,,, emacs, The GNU Emacs Manual}.
Emacs creates the initial X frame before it reads the user's init file,
which is the first occasion that the user has to set this variable. So
after reading the init file, Emacs modifies the parameters according to
the value of this variable. In most cases, that is good enough.
However, for window position parameters, it may be inconvenient that the
window initially appears in the wrong place or the wrong size. The way
to overcome this annoyance is to specify the initial frame's geometry
with an X resource.
@end defvar @end defvar
If you use options that specify window appearance when you invoke Emacs,
they take effect by adding elements to @code{default-frame-alist}. One
exception is @samp{-geometry}, which adds to @code{initial-frame-alist}
instead. @xref{Command Arguments,,, emacs, The GNU Emacs Manual}.
@defvar before-make-frame-hook @defvar before-make-frame-hook
A normal hook run by @code{make-frame} before it actually creates the A normal hook run by @code{make-frame} before it actually creates the
frame. frame.
...@@ -168,10 +183,21 @@ name is also used (instead of the name of the Emacs executable) when ...@@ -168,10 +183,21 @@ name is also used (instead of the name of the Emacs executable) when
looking up X resources for the frame. looking up X resources for the frame.
@item left @item left
The screen position of the left edge, in pixels. The screen position of the left edge, in pixels. The value may be
@code{-} instead of a number; that represents @samp{-0} in a geometry
specification.
@item top @item top
The screen position of the top edge, in pixels. The screen position of the top edge, in pixels. The value may be
@code{-} instead of a number; that represents @samp{-0} in a geometry
specification.
@item user-position
Non-@code{nil} if the screen position of the frame was explicitly
requested by the user (for example, with the @samp{-geometry} option).
Nothing automatically makes this parameter non-@code{nil}; it is up to
Lisp programs that call @code{make-frame} to specify this parameter as
well as specifying the @code{left} and @code{top} parameters.
@item height @item height
The height of the frame contents, in characters. (To get the height in The height of the frame contents, in characters. (To get the height in
...@@ -221,7 +247,7 @@ server defines the meaningful color names. ...@@ -221,7 +247,7 @@ server defines the meaningful color names.
The color to use for the background of text. The color to use for the background of text.
@item mouse-color @item mouse-color
The color for the mouse cursor. The color for the mouse pointer.
@item cursor-color @item cursor-color
The color for the cursor that shows point. The color for the cursor that shows point.
...@@ -267,10 +293,8 @@ it and see if it works.) ...@@ -267,10 +293,8 @@ it and see if it works.)
You can read or change the size and position of a frame using the You can read or change the size and position of a frame using the
frame parameters @code{left}, @code{top}, @code{height} and frame parameters @code{left}, @code{top}, @code{height} and
@code{width}. When you create a frame, you must specify either both @code{width}. Whatever geometry parameters you don't specify are chosen
size parameters or neither. Likewise, you must specify either both by the window manager in its usual fashion.
position parameters or neither. Whatever geometry parameters you don't
specify are chosen by the window manager in its usual fashion.
Here are some special features for working with sizes and positions: Here are some special features for working with sizes and positions:
...@@ -820,6 +844,35 @@ display a real dialog box; so instead it displays the same items in a ...@@ -820,6 +844,35 @@ display a real dialog box; so instead it displays the same items in a
pop-up menu in the center of the frame. pop-up menu in the center of the frame.
@end defun @end defun
@node Pointer Shapes
@section Pointer Shapes
@cindex pointer shape
@cindex mouse pointer shape
These variables specify which mouse pointer shape to use in various
situations:
@table @code
@item x-pointer-shape
@vindex x-pointer-shape
This variable specifies the pointer shape to use ordinarily in the Emacs
frame.
@item x-sensitive-text-pointer-shape
@vindex x-sensitive-text-pointer-shape
This variable specifies the pointer shape to use when the mouse
is over mouse-sensitive text.
@end table
These variables affect newly created frames. They do not normally
affect existing frames; however, if you set the mouse color of a frame,
that also updates its pointer shapes based on the current values of
these variables. @xref{X Frame Parameters}.
The values you can use, to specify either of these pointer shapes, are
defined in the file @file{lisp/x-win.el}. Use @kbd{M-x apropos
@key{RET} x-pointer @key{RET}} to see a list of them.
@node X Selections @node X Selections
@section X Selections @section X Selections
@cindex selection (for X windows) @cindex selection (for X windows)
...@@ -1036,8 +1089,4 @@ This variable's value is is @code{t} if no X window manager is in use. ...@@ -1036,8 +1089,4 @@ This variable's value is is @code{t} if no X window manager is in use.
@item @item
The functions @code{x-pixel-width} and @code{x-pixel-height} return the The functions @code{x-pixel-width} and @code{x-pixel-height} return the
width and height of an X Window frame, measured in pixels. width and height of an X Window frame, measured in pixels.
@item
x-pointer-shape, x-nontext-pointer-shape, x-mode-pointer-shape.
x-cross-pointer-shape.
@end ignore @end ignore
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment