diff options
Diffstat (limited to 'devdocs/elisp/fringe-size_002fpos.html')
| -rw-r--r-- | devdocs/elisp/fringe-size_002fpos.html | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/devdocs/elisp/fringe-size_002fpos.html b/devdocs/elisp/fringe-size_002fpos.html new file mode 100644 index 00000000..4007c319 --- /dev/null +++ b/devdocs/elisp/fringe-size_002fpos.html @@ -0,0 +1,19 @@ + <h4 class="subsection">Fringe Size and Position</h4> <p>The following buffer-local variables control the position and width of fringes in windows showing that buffer. </p> <dl> <dt id="fringes-outside-margins">Variable: <strong>fringes-outside-margins</strong> +</dt> <dd><p>The fringes normally appear between the display margins and the window text. If the value is non-<code>nil</code>, they appear outside the display margins. See <a href="display-margins">Display Margins</a>. </p></dd> +</dl> <dl> <dt id="left-fringe-width">Variable: <strong>left-fringe-width</strong> +</dt> <dd><p>This variable, if non-<code>nil</code>, specifies the width of the left fringe in pixels. A value of <code>nil</code> means to use the left fringe width from the window’s frame. </p></dd> +</dl> <dl> <dt id="right-fringe-width">Variable: <strong>right-fringe-width</strong> +</dt> <dd><p>This variable, if non-<code>nil</code>, specifies the width of the right fringe in pixels. A value of <code>nil</code> means to use the right fringe width from the window’s frame. </p></dd> +</dl> <p>Any buffer which does not specify values for these variables uses the values specified by the <code>left-fringe</code> and <code>right-fringe</code> frame parameters (see <a href="layout-parameters">Layout Parameters</a>). </p> <p>The above variables actually take effect via the function <code>set-window-buffer</code> (see <a href="buffers-and-windows">Buffers and Windows</a>), which calls <code>set-window-fringes</code> as a subroutine. If you change one of these variables, the fringe display is not updated in existing windows showing the buffer, unless you call <code>set-window-buffer</code> again in each affected window. You can also use <code>set-window-fringes</code> to control the fringe display in individual windows. </p> <dl> <dt id="set-window-fringes">Function: <strong>set-window-fringes</strong> <em>window left &optional right outside-margins persistent</em> +</dt> <dd> +<p>This function sets the fringe widths of window <var>window</var>. If <var>window</var> is <code>nil</code>, the selected window is used. </p> <p>The argument <var>left</var> specifies the width in pixels of the left fringe, and likewise <var>right</var> for the right fringe. A value of <code>nil</code> for either one stands for the default width. If <var>outside-margins</var> is non-<code>nil</code>, that specifies that fringes should appear outside of the display margins. </p> <p>If <var>window</var> is not large enough to accommodate fringes of the desired width, this leaves the fringes of <var>window</var> unchanged. </p> <p>The values specified here may be later overridden by invoking <code>set-window-buffer</code> (see <a href="buffers-and-windows">Buffers and Windows</a>) on <var>window</var> with its <var>keep-margins</var> argument <code>nil</code> or omitted. However, if the optional fifth argument <var>persistent</var> is non-<code>nil</code> and the other arguments are processed successfully, the values specified here unconditionally survive subsequent invocations of <code>set-window-buffer</code>. This can be used to permanently turn off fringes in the minibuffer window, consult the description of <code>set-window-scroll-bars</code> for an example (see <a href="scroll-bars">Scroll Bars</a>). </p> +</dd> +</dl> <dl> <dt id="window-fringes">Function: <strong>window-fringes</strong> <em>&optional window</em> +</dt> <dd><p>This function returns information about the fringes of a window <var>window</var>. If <var>window</var> is omitted or <code>nil</code>, the selected window is used. The value has the form <code>(<var>left-width</var> +<var>right-width</var> <var>outside-margins</var> <var>persistent</var>)</code>. </p></dd> +</dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> + <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Fringe-Size_002fPos.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Fringe-Size_002fPos.html</a> + </p> +</div> |