| [ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Just what parameters a frame has depends on what display mechanism it
uses. Here is a table of the parameters that have special meanings in a
window frame; of these, name, title, height,
width, buffer-list and buffer-predicate provide
meaningful information in terminal frames.
display
"host:dpy.screen", just like the
DISPLAY environment variable.
title
nil title, it appears in the window system's
border for the frame, and also in the mode line of windows in that frame
if mode-line-frame-identification uses `%F'
(see section 23.3.3 %-Constructs in the Mode Line). This is normally the case when Emacs is not
using a window system, and can only display one frame at a time.
See section 29.4 Frame Titles.
name
title parameter is unspecified or nil. If
you don't specify a name, Emacs sets the frame name automatically
(see section 29.4 Frame Titles).
If you specify the frame name explicitly when you create the frame, the name is also used (instead of the name of the Emacs executable) when looking up X resources for the frame.
left
(+ pos) which permits specifying a
negative pos value.
A negative number -pos, or a list of the form (-
pos), actually specifies the position of the right edge of the
window with respect to the right edge of the screen. A positive value
of pos counts toward the left. Reminder: if the
parameter is a negative integer -pos, then pos is
positive.
Some window managers ignore program-specified positions. If you want to
be sure the position you specify is not ignored, specify a
non-nil value for the user-position parameter as well.
top
(+ pos) which permits specifying a
negative pos value.
A negative number -pos, or a list of the form (-
pos), actually specifies the position of the bottom edge of the
window with respect to the bottom edge of the screen. A positive value
of pos counts toward the top. Reminder: if the
parameter is a negative integer -pos, then pos is
positive.
Some window managers ignore program-specified positions. If you want to
be sure the position you specify is not ignored, specify a
non-nil value for the user-position parameter as well.
icon-left
icon-top
user-position
left and top parameters, use this parameter to say whether
the specified position was user-specified (explicitly requested in some
way by a human user) or merely program-specified (chosen by a program).
A non-nil value says the position was user-specified.
Window managers generally heed user-specified positions, and some heed
program-specified positions too. But many ignore program-specified
positions, placing the window in a default fashion or letting the user
place it with the mouse. Some window managers, including twm,
let the user specify whether to obey program-specified positions or
ignore them.
When you call make-frame, you should specify a non-nil
value for this parameter if the values of the left and top
parameters represent the user's stated preference; otherwise, use
nil.
height
frame-pixel-height; see 29.3.4 Frame Size And Position.)
width
frame-pixel-width; see 29.3.4 Frame Size And Position.)
window-id
outer-window-id
minibuffer
t means
yes, nil means no, only means this frame is just a
minibuffer. If the value is a minibuffer window (in some other frame),
the new frame uses that minibuffer.
buffer-predicate
other-buffer uses this predicate (from the selected frame) to
decide which buffers it should consider, if the predicate is not
nil. It calls the predicate with one argument, a buffer, once for
each buffer; if the predicate returns a non-nil value, it
considers that buffer.
buffer-list
font
auto-raise
nil means yes).
auto-lower
nil means yes).
vertical-scroll-bars
left,
right, and nil for no scroll bars.
horizontal-scroll-bars
nil means yes). (Horizontal scroll bars are not currently
implemented.)
scroll-bar-width
icon-type
nil value specifies the default bitmap icon (a
picture of a gnu); nil specifies a text icon.
icon-name
nil, the frame's title is used.
foreground-color
default on the frame in question.
background-color
default on the frame in question.
background-mode
dark or light, according
to whether the background color is a light one or a dark one.
mouse-color
mouse.
cursor-color
cursor.
border-color
border.
scroll-bar-foreground
nil, the color for the foreground of scroll bars.
Changing this parameter is equivalent to setting the foreground color of
face scroll-bar.
scroll-bar-background
nil, the color for the background of scroll bars.
Changing this parameter is equivalent to setting the foreground color of
face scroll-bar.
display-type
color, grayscale or
mono.
cursor-type
bar,
box, and (bar . width). The symbol box
specifies an ordinary black box overlaying the character after point;
that is the default. The symbol bar specifies a vertical bar
between characters as the cursor. (bar . width) specifies
a bar width pixels wide.
The buffer-local variable cursor-type overrides the value of
the cursor-type frame parameter, and can in addition have
values t (use the cursor specified for the frame) and
nil (don't display a cursor).
border-width
internal-border-width
unsplittable
nil, this frame's window is never split automatically.
visibility
nil for invisible, t for visible, and icon for
iconified. See section 29.10 Visibility of Frames.
menu-bar-lines
screen-gamma
tool-bar-lines
nil means
don't display a tool bar.
line-spacing
| [ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |