diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/frame-interaction-parameters.html | |
new repository
Diffstat (limited to 'devdocs/elisp/frame-interaction-parameters.html')
| -rw-r--r-- | devdocs/elisp/frame-interaction-parameters.html | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/devdocs/elisp/frame-interaction-parameters.html b/devdocs/elisp/frame-interaction-parameters.html new file mode 100644 index 00000000..76f97d36 --- /dev/null +++ b/devdocs/elisp/frame-interaction-parameters.html @@ -0,0 +1,14 @@ + <h4 class="subsubsection">Frame Interaction Parameters</h4> <p>These parameters supply forms of interactions between different frames. </p> <dl compact> <dt><code>parent-frame</code></dt> <dd> +<p>If non-<code>nil</code>, this means that this frame is a child frame (see <a href="child-frames">Child Frames</a>), and this parameter specifies its parent frame. If <code>nil</code>, this means that this frame is a normal, top-level frame. </p> </dd> <dt><code>delete-before</code></dt> <dd> +<p>If non-<code>nil</code>, this parameter specifies another frame whose deletion will automatically trigger the deletion of this frame. See <a href="deleting-frames">Deleting Frames</a>. </p> </dd> <dt><code>mouse-wheel-frame</code></dt> <dd> +<p>If non-<code>nil</code>, this parameter specifies the frame whose windows will be scrolled whenever the mouse wheel is scrolled with the mouse pointer hovering over this frame, see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Mouse-Commands.html#Mouse-Commands">Mouse Commands</a> in <cite>The GNU Emacs Manual</cite>. </p> </dd> <dt><code>no-other-frame</code></dt> <dd> +<p>If this is non-<code>nil</code>, then this frame is not eligible as candidate for the functions <code>next-frame</code>, <code>previous-frame</code> (see <a href="finding-all-frames">Finding All Frames</a>) and <code>other-frame</code>, see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Frame-Commands.html#Frame-Commands">Frame Commands</a> in <cite>The GNU Emacs Manual</cite>. </p> </dd> <dt><code>auto-hide-function</code></dt> <dd> +<p>When this parameter specifies a function, that function will be called instead of the function specified by the variable <code>frame-auto-hide-function</code> when quitting the frame’s only window (see <a href="quitting-windows">Quitting Windows</a>) and there are other frames left. </p> </dd> <dt><code>minibuffer-exit</code></dt> <dd> +<p>When this parameter is non-<code>nil</code>, Emacs will by default make this frame invisible whenever the minibuffer (see <a href="minibuffers">Minibuffers</a>) is exited. Alternatively, it can specify the functions <code>iconify-frame</code> and <code>delete-frame</code>. This parameter is useful to make a child frame disappear automatically (similar to how Emacs deals with a window) when exiting the minibuffer. </p> </dd> <dt><code>keep-ratio</code></dt> <dd> +<p>This parameter is currently meaningful for child frames (see <a href="child-frames">Child Frames</a>) only. If it is non-<code>nil</code>, then Emacs will try to keep the frame’s size (width and height) ratios (see <a href="size-parameters">Size Parameters</a>) as well as its left and right position ratios (see <a href="position-parameters">Position Parameters</a>) unaltered whenever its parent frame is resized. </p> <p>If the value of this parameter is <code>nil</code>, the frame’s position and size remain unaltered when the parent frame is resized, so the position and size ratios may change. If the value of this parameter is <code>t</code>, Emacs will try to preserve the frame’s size and position ratios, hence the frame’s size and position relative to its parent frame may change. </p> <p>More individual control is possible by using a cons cell: In that case the frame’s width ratio is preserved if the <small>CAR</small> of the cell is either <code>t</code> or <code>width-only</code>. The height ratio is preserved if the <small>CAR</small> of the cell is either <code>t</code> or <code>height-only</code>. The left position ratio is preserved if the <small>CDR</small> of the cell is either <code>t</code> or <code>left-only</code>. The top position ratio is preserved if the <small>CDR</small> of the cell is either <code>t</code> or <code>top-only</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/Frame-Interaction-Parameters.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Frame-Interaction-Parameters.html</a> + </p> +</div> |
