Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Drawing Rectangles

FillRect

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

PROCEDURE FillRect (r:\xDDRect; pat: Pattern);

r

The rectangle to fill.

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 FillRect procedure draws the interior of the rectangle that you specify in the r parameter with the pattern defined in the Pattern record that you specify in the pat parameter. This procedure leaves the pen location unchanged.

SPECIAL CONSIDERATIONS

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

SEE ALSO

Listing 3-5 on page 3-20 illustrates how to use this procedure.

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 GetPattern and GetIndPattern routines, described on page 3-122 and page 3-123, respectively, to get a pattern stored in a resource.

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