FillRect

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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.

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

Parameters

hDC

[in] Handle to the device context.

lprc

[in] Long pointer to a RECTstructure 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 hbrparameter 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 hbrparameter 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 GetStockObjectfunction. If specifying a color value for the hbrparameter, 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, FillRectdoes 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

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Wingdi.h		Mgdraw.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.