Carbon


PortSize

Header: Quickdraw.h Carbon status: Supported

Changes the size of the port rectangle of the current graphics port (basic or color).

void PortSize (
    SInt16 width, 
    SInt16 height
);
Parameter descriptions
width

The width of the reset port rectangle.

height

The height of the reset port rectangle.

DISCUSSION

The PortSize function is normally called only by the Window Manager. The PortSize function changes the size of the current graphics port’s port rectangle. The upper-left corner of the port rectangle remains at its same location; the width and height of the port rectangle are set to the given width and height. In other words, PortSize moves the lower-right corner of the port rectangle to a position relative to the upper-left corner.

The PortSize function doesn’t change the clipping or visible region of the graphics port, nor does it affect the local coordinate system of the graphics port;Êit changes only the width and height of the port rectangle. Remember that all drawing occurs only in the intersection of the boundary rectangle and the port rectangle, after being cropped to the visible region and the clipping region.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)