Function: set-window-fringes

set-window-fringes is a function defined in window.c.

Signature

(set-window-fringes WINDOW LEFT-WIDTH &optional RIGHT-WIDTH OUTSIDE-MARGINS PERSISTENT)

Documentation

Set fringes of specified WINDOW.

WINDOW must specify a live window and defaults to the selected one.

Second arg LEFT-WIDTH specifies the number of pixels to reserve for the left fringe. Optional third arg RIGHT-WIDTH specifies the right fringe width. If a fringe width arg is nil, that means to use the frame's default fringe width. Default fringe widths can be set with the command set-fringe-style.

If optional fourth arg OUTSIDE-MARGINS is non-nil, draw the fringes outside of the display margins. By default, fringes are drawn between display marginal areas and the text area.

Optional fifth argument PERSISTENT non-nil means that fringe settings for WINDOW are persistent, i.e., remain unchanged when another buffer is shown in WINDOW. PERSISTENT nil means that fringes are reset from buffer local values when set-window-buffer is called on WINDOW with the argument KEEP-MARGINS nil.

Leave fringes unchanged if WINDOW is not large enough to accommodate fringes of the desired width. Return t if any fringe was actually changed and nil otherwise.

View in manual

Probably introduced at or before Emacs version 22.1.

Source Code

// Defined in /usr/src/emacs/src/window.c
{
  struct window *w
    = set_window_fringes (decode_live_window (window), left_width,
			  right_width, outside_margins, persistent);
  return w ? (apply_window_adjustment (w), Qt) : Qnil;
}