Skip to main content

21 Frames and Graphical Displays

When Emacs is started on a graphical display, e.g., on the X Window System, it occupies a graphical system-level display region. In this manual, we call this a frame, reserving the word “window" for the part of the frame used for displaying a buffer. A frame initially contains one window, but it can be subdivided into multiple windows (see Windows). A frame normally also contains a menu bar, tool bar, and echo area.

You can also create additional frames (see Creating Frames). All frames created in the same Emacs session have access to the same underlying buffers and other data. For instance, if a buffer is being shown in more than one frame, any changes made to it in one frame show up immediately in the other frames too.

Typing C-x C-c closes all the frames on the current display, and ends the Emacs session if it has no frames open on any other displays (see Exiting). To close just the selected frame, type C-x 5 0 (that is zero, not o).

This chapter describes Emacs features specific to graphical displays (particularly mouse commands), and features for managing multiple frames. On text terminals, many of these features are unavailable. However, it is still possible to create multiple frames on text terminals; such frames are displayed one at a time, filling the entire terminal screen (see Non-Window Terminals). It is also possible to use the mouse on some text terminals (see Text-Only Mouse, for doing so on GNU and Unix systems; and see MS-DOS Mouse, for doing so on MS-DOS). Menus are supported on all text terminals.

Mouse Commands  Moving, cutting, and pasting, with the mouse.
Word and Line Mouse  Mouse commands for selecting whole words or lines.
Mouse References  Using the mouse to select an item from a list.
Menu Mouse Clicks  Mouse clicks that bring up menus.
Mode Line Mouse  Mouse clicks on the mode line.
Creating Frames  Creating additional Emacs frames with various contents.
Frame Commands  Iconifying, deleting, and switching frames.
Fonts  Changing the frame font.
Speedbar  How to make and use a speedbar frame.
Multiple Displays  How one Emacs instance can talk to several displays.
Frame Parameters  Changing the colors and other modes of frames.
Scroll Bars  How to enable and disable scroll bars; how to use them.
Window Dividers  Window separators that can be dragged with the mouse.
Drag and Drop  Using drag and drop to open files and insert text.
Menu Bars  Enabling and disabling the menu bar.
Tool Bars  Enabling and disabling the tool bar.
Tab Bars  Enabling and disabling the tab bar.
Dialog Boxes  Controlling use of dialog boxes.
Tooltips  Displaying information at the current mouse position.
Mouse Avoidance  Preventing the mouse pointer from obscuring text.
Non-Window Terminals  Multiple frames on terminals that show only one.
Text-Only Mouse  Using the mouse in text terminals.