Emacs/emacs/Frames

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.