Share via


CDC::FillSolidRect

Call this member function to fill the given rectangle with the specified solid color.

void FillSolidRect(
   LPCRECT lpRect,
   COLORREF clr 
);
void FillSolidRect(
   int x,
   int y,
   int cx,
   int cy,
   COLORREF clr 
);

Parameters

  • lpRect
    Specifies the bounding rectangle (in logical units). You can pass either a pointer to a RECT data structure or a CRect object for this parameter.

clr   Specifies the color to be used to fill the rectangle.

  • x
    Specifies the logical x-coordinate of the upper-left corner of the rectangle.

  • y
    Specifies the logical y-coordinate of the upper-left corner of the destination rectangle.

  • cx
    Specifies the width of the rectangle.

  • cy
    Specifies the height of the rectangle.

Remarks

FillSolidRect is very similar to CDC::FillRect; however, FillSolidRect uses only solid colors (indicated by the COLORREF parameter), while FillRect takes a brush and therefore can be used to fill a rectangle with a solid color, a dithered color, hatched brushes, or a pattern. FillSolidRect usually is faster than FillRect.

Note

When you call FillSolidRect, the background color, which was previously set using SetBkColor, is set to the color indicated by clr.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

RECT Structure

CRect Class

CDC::FillRect

Other Resources

CDC Members