All DatabasesInside Mac - Basic Toolbox
NewRgn
NewRgn Create an empty Region; obtain a region handle
#include <Quickdraw.h> Quickdraw
RgnHandle NewRgn( );
NewRgn allocates storage for a Region structure and a RgnPtr, initializes the
contents of the Region to make it an empty rectangle. It returns a pointer to
the RgnPtr - a RgnHandle.
Returns: a RgnHandle that leads to a region defined by an empty rectangle
(0,0,)(0,0).
Notes: A Region is a variable-length structure; the contents and position of the
actual data may be moved around by the system without affecting the value
of the RgnHandle. See Region for the structure layout and list of functions
that use regions.
The Region created by this call is 10 bytes long; a 2-byte length,
initialized to 10, and an 8-byte Rect structure initialized to (0,0)(0,0).
This function must be used to allocate a region before calling any XxxRgn
calls (e.g., CloseRgn, CopyRgn, et.al.) which require a destination
region.
Referenced by (51):