Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

FillRect function

The FillRect function fills a rectangle by using the specified brush. This function includes the left and top borders, but excludes the right and bottom borders of the rectangle.

Syntax


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

Parameters

hDC [in]

A handle to the device context.

lprc [in]

A pointer to a RECT structure that contains the logical coordinates of the rectangle to be filled.

hbr [in]

A handle to the brush used to fill the rectangle.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

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_WINDOW+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.

Examples

For an example, see Using Rectangles.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Filled Shapes Overview
Filled Shape Functions
CreateHatchBrush
CreatePatternBrush
CreateSolidBrush
GetStockObject
RECT

 

 

Build date: 6/12/2013

Community Additions

Show:
© 2014 Microsoft. All rights reserved.