FillRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function fills a rectangle using the specified brush. This function fills the rectangle's left and top borders, but excludes the right and bottom borders.

Syntax

int FillRect(
  HDC hDC, 
  CONST RECT* lprc, 
  HBRUSH hbr
); 

Parameters

• hDC
  [in] Handle to the device context.

• lprc
  [in] Long pointer to a RECT structure that contains the logical coordinates of the rectangle to be filled.

• hbr
  [in] Handle to the brush used to fill the rectangle.

  In Windows CE 1.0 and 1.01, the hbr parameter cannot be a color brush.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The brush identified by the hbr parameter may be either a handle to a logical brush or a color value.

If specifying a handle to a logical brush, call CreatePatternBrush, or CreateSolidBrush to obtain the handle. Additionally, you may retrieve a handle to one of the stock brushes by using the GetStockObject function.

If specifying a color value for the hbr parameter, it must be one of the standard system colors (the value 1 must be added to the chosen color). For example,

FillRect(hdc, &rect, (HBRUSH) (COLOR_ENDCOLORS+1));

For a list of all the standard system colors, see GetSysColor.

When filling the specified rectangle, FillRect does not include the rectangle's right and bottom sides.

GDI fills a rectangle up to, but not including, the right column and bottom row, regardless of the current mapping mode.

Requirements

See Also

Reference

CreatePatternBrush
CreateSolidBrush
GetStockObject
GetSysColor
RECT
GDI Functions