GetNewWindow

Create a window as defined in a resource

#include <Windows.h> Window Manager

WindowPtr GetNewWindow( windowID, wStorage, behind );

short windowID ; resource ID of a window template

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

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

returns address of a WindowRecord; 0 if error

GetNewWindow creates and optionally draws a window in the same way as

NewWindow, but gets the size, title, and other options from a resource file.

windowID is the resource ID (type 'WIND') of the template of the window 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

heap.

This parameter affects which function you should use when you close

the window. See Notes, below.

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

other windows on the screen. It is one of:

-1 In front of all other windows(you need to cast this to a

WindowPtr)

NIL Behind all other windows

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

Returns: a WindowPtr identifying the new window. A value of NIL indicates

that the operation was unsuccessful.

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

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

window parameters without having to recompile the program.

If wStorage is NIL (to allocate the window's WindowRecord 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

the stack), use CloseWindow to close it.

Referenced by (63):