A frame contains and displays one or more Emacs windows.
Outside of Emacs, frames are usually called “windows”.
Outside of Emacs, Emacs windows might be called “panes”, “sub-windows”, or “MDI windows”.
When running on a graphic display, an Emacs frame is implemented as a window-manager window.
In a character-cell terminal (such as a text console or an xterm) there is an implicit Emacs frame for the terminal. You can create additional frames – each is in effect a virtual terminal.
A frame is rectangular, with four borders. On a graphic display, a frame usually has a title bar, showing the FrameTitle. By default, a frame has a MenuBar, just under the title bar. On a graphic displays, by default a frame also has a ToolBar with icon buttons.
In this screenshot, colored boxes indicate the frame (red), and three windows (in blue, green, and yellow) in the frame.
A frame can be visible (raised), invisible, or iconified (minimized).
A raised frame can be maximized, occupying the full screen, or not. You can resize a frame, drag it around, iconify/minimize it, restore it, rename it, or delete it.
Most frame-related KeySequences are prefixed with C-x 5.
Key | Meaning | Command |
C-x 5 o | Switch to other frame | other-frame |
C-x 5 0 | Delete the selected frame | delete-frame |
C-x 5 1 | Delete all frames except the selected one | delete-other-frames |
C-x 5 2 | Create a new frame on the same terminal | make-frame-command |
C-x C-z | Iconify or raise graphic-display frame | suspend-frame |
M-F10 | Maximize or unmaximize frame (toggle) | toggle-frame-maximized |
F11 | Make frame fullscreen or restore fullscreen frame to previous size (toggle) | toggle-frame-maximized |