de_create_window()

Creates and opens a window. Returns the handle to the opened window.

See also: de_close_window().

Syntax

de_create_window(window_code[, winInstP, xLoc, yLoc, width, height]);

where

window_code is the code for type of window; one of the following:

• SCHEM_WIN = Schematic window
• LAYOUT_WIN = Layout window

winInstP is optional. NULL if no parent window; otherwise, winInst of parent window with design to show in newly-created window. The cfg env vars are:

• SCHEMATIC/LAYOUT_WINDOW_X_LOC
• SCHEMATIC/LAYOUT_WINDOW_Y_LOC
• SCHEMATIC/LAYOUT_WINDOW_HEIGHT
• SCHEMATIC/LAYOUT_WINDOW_WIDTH

If you don't specify the xLoc, yLoc, width, and height, then:

• If there are no windows open, then open the window with the coordinates, width, and height specified by the cfg env vars.
• If there are windows open, then instead of using the coordinates specified by the cfg env vars, open the window to the lower right of the most-recently opened window, but still use the width and height specified by the cfg env vars.
• If you are reattaching to a project which had windows open before you reattached to it (that is, save project state), then restore the windows, to the coordinates, width and height, that they had before.

xLoc, yLoc is optional. Initial position for the window.

width is optional. Width of window in user units.

height is optional. Height of window in user units.

Example:

// sets the layout window active and creates a rectangle in it.
de_create_window(LAYOUT_WIN);
rectangle (10.3,0,14.5,11);

Where Used:

Schematic, Layout