FillRect 函数 (winuser.h)

项目
08/27/2023

FillRect 函数使用指定的画笔填充矩形。此函数包括左边框和上边框，但不包括矩形的右边框和下边框。

语法

int FillRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

参数

[in] hDC

设备上下文的句柄。

[in] lprc

指向 RECT 结构的指针，该结构包含要填充的矩形的逻辑坐标。

[in] hbr

用于填充矩形的画笔的句柄。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注解

由 hbr 参数标识的画笔可以是逻辑画笔的句柄，也可以是颜色值。如果为逻辑画笔指定句柄，请调用以下函数之一以获取句柄： CreateHatchBrush、 CreatePatternBrush 或 CreateSolidBrush。此外，还可以使用 GetStockObject 函数检索其中一个股票画笔的句柄。如果为 hbr 参数指定颜色值，则它必须是标准系统颜色之一， (必须将值 1 添加到所选颜色) 。例如：


FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));

有关所有标准系统颜色的列表，请参阅 GetSysColor。

填充指定矩形时， FillRect 不包括矩形的右侧和底部。无论当前映射模式如何，GDI 都会填充一个矩形，但不包括右列和底部行。

示例

有关示例，请参阅使用矩形。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-gui-l1-1-0 (