Next: , Previous: Size Parameters, Up: Window Frame Parameters

29.4.3.4 Layout Parameters

These frame parameters enable or disable various parts of the frame, or control their sizes.

border-width
The width in pixels of the frame's outer border (see Frame Geometry).


internal-border-width
The width in pixels of the frame's internal border (see Frame Geometry).


vertical-scroll-bars
Whether the frame has scroll bars (see Scroll Bars) for vertical scrolling, and which side of the frame they should be on. The possible values are left, right, and nil for no scroll bars.


horizontal-scroll-bars
Whether the frame has scroll bars for horizontal scrolling (t and bottom mean yes, nil means no).


scroll-bar-width
The width of vertical scroll bars, in pixels, or nil meaning to use the default width.


scroll-bar-height
The height of horizontal scroll bars, in pixels, or nil meaning to use the default height.


left-fringe
right-fringe
The default width of the left and right fringes of windows in this frame (see Fringes). If either of these is zero, that effectively removes the corresponding fringe.

When you use frame-parameter to query the value of either of these two frame parameters, the return value is always an integer. When using set-frame-parameter, passing a nil value imposes an actual default value of 8 pixels.


right-divider-width
The width (thickness) reserved for the right divider (see Window Dividers) of any window on the frame, in pixels. A value of zero means to not draw right dividers.


bottom-divider-width
The width (thickness) reserved for the bottom divider (see Window Dividers) of any window on the frame, in pixels. A value of zero means to not draw bottom dividers.


menu-bar-lines
The number of lines to allocate at the top of the frame for a menu bar (see Menu Bar). The default is one if Menu Bar mode is enabled and zero otherwise. See Menu Bars. For an external menu bar (see Frame Layout), this value remains unchanged even when the menu bar wraps to two or more lines. In that case, the menu-bar-size value returned by frame-geometry (see Frame Geometry) allows to derive whether the menu bar actually occupies one or more lines.


tool-bar-lines
The number of lines to use for the tool bar (see Tool Bar). The default is one if Tool Bar mode is enabled and zero otherwise. See Tool Bars. This value may change whenever the tool bar wraps (see Frame Layout).


tool-bar-position
The position of the tool bar when Emacs was built with GTK+. Its value can be one of top, bottom left, right. The default is top.


line-spacing
Additional space to leave below each text line, in pixels (a positive integer). See Line Height, for more information.


no-special-glyphs
If this is non-nil, it suppresses the display of any truncation and continuation glyphs (see Truncation) for all buffers displayed by this frame. This is useful to eliminate such glyphs when fitting a frame to its buffer via fit-frame-to-buffer (see Resizing Windows).