Previous: , Up: Frames and Terminals   [Index]


G.4.2 Creating Frames

Call the function make-frame.

Command: make-frame &optional parameters

This function creates and returns a new frame, displaying the current buffer.

PARAMETERS

an alist of frame parameters for the new frame. Each element of PARAMETERS should have the form (NAME . VALUE)

  • (name . STRING) – frame is named STRING
  • (width . NUMBER) – frame should be NUMBER characters in width
  • (height . NUMBER) – frame should be NUMBER text lines high
  • (minibuffer . t) – the frame should have a minibuffer
  • (minibuffer . nil) – the frame should have no minibuffer
  • (minibuffer . only) – the frame should contain only a minibuffer window
  • (minibuffer . WINDOW) – the frame should use WINDOW as its minibuffer window
  • (window-system . nil) – the frame should be displayed on a terminal device
  • (window-system . x) – the frame should be displayed in an X window
  • (display . ":0") – the frame should appear on display :0
  • (terminal . TERMINAL) – the frame should use the terminal object TERMINAL
  • any parameter not specified in ‘PARAMETERS’ default to values found in default-frame-alist.
HOOKS
before-make-frame-hook

A normal hook run by ‘make-frame’ before it creates the frame.

after-make-frame-functions

An abnormal hook run by make-frame after it created the frame. Each function in after-make-frame-functions receives one argument, the frame just created.

server-after-make-frame-hook

A normal hook run when the Emacs server creates a client frame. When this hook is called, the created frame is the selected one.

PARAMETER-VARIABLE
frame-inherited-parameters

This variable specifies the list of frame parameters that a newly created frame inherits from the currently selected frame.


Previous: Frame and Terminal Functions, Up: Frames and Terminals   [Index]