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

28.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.

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.

The combined fringe widths must add up to an integral number of columns, so the actual default fringe widths for the frame, as reported by frame-parameter, may be larger than what you specify. Any extra width 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.


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. The default is 1 if Menu Bar mode is enabled, and 0 otherwise. See Menu Bars.


tool-bar-lines
The number of lines to use for the tool bar. The default is 1 if Tool Bar mode is enabled, and 0 otherwise. See Tool Bars.


tool-bar-position
The position of the tool bar. Currently only for the GTK tool bar. 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.