Share via

FillRect

  • Article

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

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CreatePatternBrush
CreateSolidBrush
GetStockObject
GetSysColor
RECT
GDI Functions