Next: Window History, Previous: Display Action Functions, Up: Windows [Contents][Index]
The behavior of the standard display actions of display-buffer
(see Choosing Window) can be modified by a variety of user
options.
If the value of this variable is non-nil, display-buffer
is allowed to split an existing window to make a new window for
displaying in. This is the default.
This variable is provided mainly for backward compatibility. It is
obeyed by display-buffer via a special mechanism in
display-buffer-fallback-action, which only calls the action
function display-buffer-pop-up-window (see Display Action Functions) when the value is nil. It is not consulted by
display-buffer-pop-up-window itself, which the user may specify
directly in display-buffer-alist etc.
This variable specifies a function for splitting a window, in order to
make a new window for displaying a buffer. It is used by the
display-buffer-pop-up-window action function to actually split
the window (see Display Action Functions).
The default value is split-window-sensibly, which is documented
below. The value must be a function that takes one argument, a window,
and return either a new window (which will be used to display the
desired buffer) or nil (which means the splitting failed).
This function tries to split window, and return the newly
created window. If window cannot be split, it returns
nil.
This function obeys the usual rules that determine when a window may
be split (see Splitting Windows). It first tries to split by
placing the new window below, subject to the restriction imposed by
split-height-threshold (see below), in addition to any other
restrictions. If that fails, it tries to split by placing the new
window to the right, subject to split-width-threshold (see
below). If that fails, and the window is the only window on its
frame, this function again tries to split and place the new window
below, disregarding split-height-threshold. If this fails as
well, this function gives up and returns nil.
This variable, used by split-window-sensibly, specifies whether
to split the window placing the new window below. If it is an
integer, that means to split only if the original window has at least
that many lines. If it is nil, that means not to split this
way.
This variable, used by split-window-sensibly, specifies whether
to split the window placing the new window to the right. If the value
is an integer, that means to split only if the original window has at
least that many columns. If the value is nil, that means not
to split this way.
If the value of this variable is non-nil, that means
display-buffer may display buffers by making new frames. The
default is nil.
A non-nil value also means that when display-buffer is
looking for a window already displaying buffer-or-name, it can
search any visible or iconified frame, not just the selected frame.
This variable is provided mainly for backward compatibility. It is
obeyed by display-buffer via a special mechanism in
display-buffer-fallback-action, which calls the action function
display-buffer-pop-up-frame (see Display Action Functions)
if the value is non-nil. (This is done before attempting to
split a window.) This variable is not consulted by
display-buffer-pop-up-frame itself, which the user may specify
directly in display-buffer-alist etc.
This variable specifies a function for creating a new frame, in order
to make a new window for displaying a buffer. It is used by the
display-buffer-pop-up-frame action function (see Display Action Functions).
The value should be a function that takes no arguments and returns a
frame, or nil if no frame could be created. The default value
is a function that creates a frame using the parameters specified by
pop-up-frame-alist (see below).
This variable holds an alist of frame parameters (see Frame Parameters), which is used by the default function in
pop-up-frame-function to make a new frame. The default is
nil.
A list of buffer names for buffers that should be displayed in the
selected window. If a buffer’s name is in this list,
display-buffer handles the buffer by showing it in the selected
window.
A list of regular expressions that specify buffers that should be
displayed in the selected window. If the buffer’s name matches any of
the regular expressions in this list, display-buffer handles the
buffer by showing it in the selected window.
This function returns t if displaying a buffer
named buffer-name with display-buffer would
put it in the selected window.
Next: Window History, Previous: Display Action Functions, Up: Windows [Contents][Index]