Variable: fit-frame-to-buffer-margins

fit-frame-to-buffer-margins is a customizable variable defined in window.el.gz.

Value

(nil nil nil nil)

Documentation

Margins around frame for fit-frame-to-buffer(var)/fit-frame-to-buffer(fun).

This specifies the numbers of pixels to be left free on the left, above, on the right, and below a frame fitted to its buffer. Set this to avoid obscuring other desktop objects like the taskbar. The default is nil for each side, which means to not add margins.

The value specified here can be overridden for a specific frame by that frame's fit-frame-to-buffer-margins parameter, if present. See also fit-frame-to-buffer-sizes.

This variable was added, or its default value changed, in Emacs 24.4.

View in manual

Probably introduced at or before Emacs version 24.4.

Source Code

;; Defined in /usr/src/emacs/lisp/window.el.gz
(defcustom fit-frame-to-buffer-margins '(nil nil nil nil)
  "Margins around frame for `fit-frame-to-buffer'.
This specifies the numbers of pixels to be left free on the left,
above, on the right, and below a frame fitted to its buffer.  Set
this to avoid obscuring other desktop objects like the taskbar.
The default is nil for each side, which means to not add margins.

The value specified here can be overridden for a specific frame
by that frame's `fit-frame-to-buffer-margins' parameter, if
present.  See also `fit-frame-to-buffer-sizes'."
  :version "24.4"
  :type '(list
	  (choice
	   :tag "Left"
	   :value nil
	   :format "%[LeftMargin%] %v  "
	   (const :tag "None" :format "%t" nil)
	   (integer :tag "Pixels" :size 5))
	  (choice
	   :tag "Top"
	   :value nil
	   :format "%[TopMargin%] %v  "
	   (const :tag "None" :format "%t" nil)
	   (integer :tag "Pixels" :size 5))
	  (choice
	   :tag "Right"
	   :value nil
	   :format "%[RightMargin%] %v  "
	   (const :tag "None" :format "%t" nil)
	   (integer :tag "Pixels" :size 5))
	  (choice
	   :tag "Bottom"
	   :value nil
	   :format "%[BottomMargin%] %v  "
	   (const :tag "None" :format "%t" nil)
	   (integer :tag "Pixels" :size 5)))
  :group 'help)