Variable: desktop-restore-forces-onscreen

desktop-restore-forces-onscreen is a customizable variable defined in desktop.el.gz.

Value

t

Documentation

If t, restores frames that are fully offscreen onscreen instead.

If all, also restores frames that are partially offscreen onscreen.

Note that checking of frame boundaries is only approximate. It can fail to reliably detect frames whose onscreen/offscreen state depends on a few pixels, especially near the right / bottom borders of the screen. Text-mode frames are always considered onscreen, so this option has no effect on restoring frames in a non-GUI session.

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

Probably introduced at or before Emacs version 24.4.

Source Code

;; Defined in /usr/src/emacs/lisp/desktop.el.gz
(defcustom desktop-restore-forces-onscreen t
  "If t, restores frames that are fully offscreen onscreen instead.
If `all', also restores frames that are partially offscreen onscreen.

Note that checking of frame boundaries is only approximate.
It can fail to reliably detect frames whose onscreen/offscreen state
depends on a few pixels, especially near the right / bottom borders
of the screen.
Text-mode frames are always considered onscreen, so this option has
no effect on restoring frames in a non-GUI session."
  :type '(choice (const :tag "Only fully offscreen frames" t)
		 (const :tag "Also partially offscreen frames" all)
		 (const :tag "Do not force frames onscreen" nil))
  :version "24.4")