The following frame parameters control various aspects of the frame's interaction with the window manager or window system. They have no effect on text terminals.
tfor visible, and
iconfor iconified. See Visibility of Frames.
nil, Emacs automatically raises the frame when it is selected. Some window managers do not allow this.
nil, Emacs automatically lowers the frame when it is deselected. Some window managers do not allow this.
nilspecifies no icon (in which case the window manager decides what to show); any other non-
nilvalue specifies the default Emacs icon.
nil, the frame's title is used.
window-id, changing this parameter has no actual effect.
nil, tell Xt to wait for the window manager to confirm geometry changes. Some window managers, including versions of Fvwm2 and KDE, fail to confirm, so Xt hangs. Set this to
nilto prevent hanging with those window managers.
nil, the frame is visible on all virtual desktops on systems with virtual desktops.
nil, the frame is drawn to the screen without double buffering. Emacs normally attempts to use double buffering, where available, to reduce flicker. Set this property if you experience display bugs or pine for that retro, flicker-y feeling.
nil, this tells the window manager to remove the frame's icon from the taskbar associated with the frame's display and inhibit switching to the frame's window via the combination Alt-<TAB>. On MS-Windows, iconifying such a frame will "roll in" its window-system window at the bottom of the desktop. Some window managers may not honor this parameter.
nil, this means that the frame does not want to receive input focus when it is mapped (see Visibility of Frames). Some window managers may not honor this parameter.
nil, this means that the frame does not want to receive input focus via explicit mouse clicks or when moving the mouse into it either via
focus-follows-mouse(see Input Focus) or
mouse-autoselect-window(see Mouse Window Auto-selection). This may have the unwanted side-effect that a user cannot scroll a non-selected frame with the mouse. Some window managers may not honor this parameter.
nil, this frame's window-system window is drawn without decorations, like the title, minimize/maximize boxes and external borders. This usually means that the window cannot be dragged, resized, iconified, maximized or deleted with the mouse. If
nil, the frame's window is usually drawn with all the elements listed above unless their display has been suspended via window manager settings.
Under X, Emacs uses the Motif window manager hints to turn off decorations. Some window managers may not honor these hints.
NS builds consider the tool bar to be a decoration, and therefore hide it on an undecorated frame.
nil, this means that this is an override redirect frame—a frame not handled by window managers under X. Override redirect frames have no window manager decorations, can be positioned and resized only via Emacs' positioning and resizing functions and are usually drawn on top of all other frames. Setting this parameter has no effect on MS-Windows.
darkdraw this frame's window-system window using the “vibrant dark” theme, otherwise use the system default. The “vibrant dark” theme can be used to set the toolbar and scrollbars to a dark appearance when using an Emacs theme with a dark background.
nil, set the titlebar and toolbar to be transparent. This effectively sets the background color of both to match the Emacs background color.