GNU Info

(elisp)Frames

---

Next: Positions Prev: Windows Up: Top

---

Enter node , (file) or (file)node

Frames
******

   A "frame" is a rectangle on the screen that contains one or more
Emacs windows.  A frame initially contains a single main window (plus
perhaps a minibuffer window), which you can subdivide vertically or
horizontally into smaller windows.

   When Emacs runs on a text-only terminal, it starts with one
"terminal frame".  If you create additional ones, Emacs displays one
and only one at any given time--on the terminal screen, of course.

   When Emacs communicates directly with a supported window system, such
as X, it does not have a terminal frame; instead, it starts with a
single "window frame", but you can create more, and Emacs can display
several such frames at once as is usual for window systems.

 - Function: framep object
     This predicate returns a non-`nil' value if OBJECT is a frame, and
     `nil' otherwise.  For a frame, the value indicates which kind of
     display the frame uses:

    `x'
          The frame is displayed in an X window.

    `t'
          A terminal frame on a character display.

    `mac'
          The frame is displayed on a Macintosh.

    `w32'
          The frame is displayed on MS-Windows 9X/NT.

    `pc'
          The frame is displayed on an MS-DOS terminal.

Creating Frames

Creating additional frames.

Multiple Displays

Creating frames on other displays.

Frame Parameters

Controlling frame size, position, font, etc.

Frame Titles

Automatic updating of frame titles.

Deleting Frames

Frames last until explicitly deleted.

Finding All Frames

How to examine all existing frames.

Frames and Windows

A frame contains windows;

display of text always works through windows.

Minibuffers and Frames

How a frame finds the minibuffer to use.

Input Focus

Specifying the selected frame.

Visibility of Frames

Frames may be visible or invisible, or icons.

Raising and Lowering

Raising a frame makes it hide other windows;

lowering it makes the others hide them.

Frame Configurations

Saving the state of all frames.

Mouse Tracking

Getting events that say when the mouse moves.

Mouse Position

Asking where the mouse is, or moving it.

Pop-Up Menus

Displaying a menu for the user to select from.

Dialog Boxes

Displaying a box to ask yes or no.

Pointer Shapes

Specifying the shape of the mouse pointer.

Window System Selections

Transferring text to and from other X clients.

Color Names

Getting the definitions of color names.

Text Terminal Colors

Defining colors for text-only terminals.

Resources

Getting resource values from the server.

Display Feature Testing

Determining the features of a terminal.

   Note: Display, for information about the related topic of
controlling Emacs redisplay.