FillRect

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.

At a Glance

Header file:	Wingdi.h
Windows CE versions:	1.0 and later

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 versions 1.0 and 1.01, the hbr parameter cannot be a color brush.

Return Values

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 one of the following functions to obtain the handle: CreateHatchBrush, CreatePatternBrush, or CreateSolidBrush. 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.