#include <Windows.h> Window Manager

WindowPtr GetNewCWindow( windowID, wStorage, behind );

short windowID ; resource ID of a color window template

Ptr wStorage ; address of a CWindowRecord; NIL=allocate one

WindowPtr behind ; -1=in front; NIL=in back; else= window

returns address of a CWindowRecord; 0 if error

GetNewCWindow creates and optionally draws a color window in the same

way as NewCWindow, but gets the color, size, title, and other options from a

windowID is the resource ID (type 'WIND') of the window template to create.

wStorage points to where the window should be stored. A value of NIL causes

the window storage to be allocated as a nonrelocatable object in the

This parameter affects which function you should use when you close

behind specifies the window's plane - whether it is in front of or behind

else A CWindowPtr; the new window will be behind this one

Returns: a CWindowPtr identifying the new color window. A value of NIL

Notes: This function lets you define the layout of the window as a resource. It is

preferred over NewCWindow since it saves code and lets you modify the

When GetNewCWindow is called, it loads the 'WIND' resource with

windowID and looks for a 'wctb' resource with the same resource ID. If a

'wctb' resource is found, it is used as the color table for the window. The

window's color table can be accessed using GetAuxWin. If no 'wctb'

resource is found, then the default 'wctb' (resource ID = 0) is used.

Note that GetNewCWindow does not set the port to the new window. This

The window's backColor becomes the new content color, allowing an

application to use EraseRect to begin an update and still not affect the

If wStorage is NIL (to allocate the window's CWindowRecord on the heap),

use DisposeWindow to close the window and deallocate the storage. If

wStorage points to within your own data area (e.g., as an auto variable on