Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Drawing Rounded Rectangles

FillRoundRect

To fill a rounded rectangle with any available bit pattern, use the FillRoundRect procedure.

PROCEDURE FillRoundRect (r:\xDDRect; ovalWidth,ovalHeight: Integer; 
                        pat: Pattern);

r

The rectangle that defines the rounded rectangle's boundaries.

ovalWidth

The width of the oval defining the rounded corner.

ovalHeight

The height of the oval defining the rounded corner.

pat

The bit pattern to use for the fill. Figure 3-3 on page 3-6 illustrates the default fill patterns and the constants you can use to represent them.

DESCRIPTION

Using the patCopy pattern mode, the FillRoundRect procedure draws the interior of the rounded rectangle bounded by the rectangle that you specify in the r parameter with the bit pattern defined in the Pattern record that you specify in the pat parameter. Use the ovalWidth and ovalHeight parameters to specify the diameters of curvature for the corners. The pen location does not change.

SPECIAL CONSIDERATIONS

The FillRoundRect procedure may move or purge memory blocks in the application heap. Your application should not call this procedure at interrupt time.

SEE ALSO

You can use the GetPattern and GetIndPattern routines, described on page 3-122 and page 3-123, respectively, to get a pattern stored in a resource. The patCopy pattern mode is described in "Boolean Transfer Modes With 1-Bit Pixels" beginning on page 3-7. The Pattern record is described on page 3-36.

You can use the PaintRoundRect procedure, described in the previous section, to draw the interior of a rounded rectangle with the pen pattern for the current graphics port. To fill a rounded rectangle with a pixel pattern, use the FillCRoundRect procedure, which is described in the chapter "Color QuickDraw."