Important: The information in this document is obsolete and should not be used for new development.
FrameRgn
To draw an outline inside a region, use theFrameRgn
procedure.
PROCEDURE FrameRgn (rgn:\xDDRgnHandle);
rgn
- A handle to the region to frame.
DESCRIPTION
Using the current graphics port's pen pattern, pattern mode, and pen size, theFrameRgn
procedure draws an outline just inside the region whose handle you pass in the rgn parameter. The outline never goes outside the region boundary. The pen location does not change.If a region is open and being formed, the outside outline of the region being framed is mathematically added to that region's boundary.
SPECIAL CONSIDERATIONS
TheFrameRgn
procedure calls the routinesCopyRgn
,InsetRgn
, andDiffRgn
, soFrameRgn
may temporarily use heap space that's three times the size of the original region.The
FrameRgn
procedure may move or purge memory blocks in the application heap. Your application should not call this procedure at interrupt time.