29.3.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 border.

internal-border-width

The distance in pixels between text (or fringe) and the frame's border.

vertical-scroll-bars

Whether the frame has 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.

scroll-bar-width

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

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. A value of nil stands for the standard fringe width, which is the width needed to display the fringe bitmaps.

The combined fringe widths must add up to an integral number of columns, so the actual default fringe widths for the frame may be larger than the specified values. The extra width needed to reach an acceptable total is distributed evenly between the left and right fringe. However, you can force one fringe or the other to a precise width by specifying that width as a negative integer. If both widths are negative, only the left fringe gets the specified width.

menu-bar-lines

The number of lines to allocate at the top of the frame for a menu bar. The default is 1. A value of nil means don't display a menu bar. See Menu Bar. (The X toolkit and GTK allow at most one menu bar line; they treat larger values as 1.)

tool-bar-lines

The number of lines to use for the tool bar. A value of nil means don't display a tool bar. (GTK and Nextstep allow at most one tool bar line; they treat larger values as 1.)

line-spacing

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