FillRect (Windows CE 5.0)

Send Feedback

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.

intFillRect(HDChDC, CONSTRECT* lprc, HBRUSHhbr);

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 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 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

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

CreatePatternBrush | CreateSolidBrush | GetStockObject | GetSysColor | RECT | GDI Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.