# popup-window(2)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## NAME

popup-window - Pop-up a window on the screen

## SYNOPSIS

n popup-window "name"

## DESCRIPTION

popup-window manages the display of a new window on the screen. If only one window exists then it will be split else the current window will changed to one of the other existing visible windows. If the given buffer name "name" is not null ("") then the buffer is created, if it does not exist, and swapped in.

The numeric argument n alters the behavior of the command as follows:

`0`

When n is zero is given then the command only succeeds if the given buffer is already being displayed in an existing window, this window is made current.

`1`

When n is 1 and the given buffer is not visible then a window displaying a system buffer is chosen in preference. A system buffer is one who's name starts with a '`*`' character, e.g. "`*help*`". window used to display

`2`

When n is 2 the frame containing the buffer is made current, this will interact with the window manager and bring MicroEmacs to the top of the window stack and bring it into focus. The name argument is not required.

`3`

When n is 3 then the frame position on the Desktop Window is allowed to be re-positioned, this is typically called after a font change or screen re-size operation and ensures that the MicroEmacs window is positioned on the screen. The name argument is not required.

`4`

When n is 4 then both the frame position and frame size on the Desktop Window is adjusted, this is the same as `3` except the frame size may also be adjusted to fit on the desktop. The name argument is not required.

## SEE ALSO

find-buffer(2).

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>