FillRect

小甲鱼

函数功能：

FillRect 函数使用指定的画刷填充矩形，该函数包含矩形的左、顶边，但不包含右、底边。


API 函数原型：

注释：_In_ 说明该参数是输入的。

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

参数解析：

参数	含义
hDC	指定设备环境句柄
lprc	指向 RECT 结构的指针，该结构为待填充的矩形，使用逻辑坐标
hbr	指定用于填充的画刷句柄

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。


备注：

1. hbr 参数可以指定为一个画刷的句柄，也可以指定为一个颜色值。如果希望指定一个逻辑画刷，可以通过调用以下 API 函数来获得画刷句柄：CreateHatchBrush，CreatePatternBrush 或 CreateSolidBrush。此外，你还可以使用 GetStockOjbect 函数获得系统预设的画刷句柄。

2. 如果 hbr 参数指定为一个颜色值，它必须是一个标准的系统颜色（必须为选定的颜色值 + 1），例如：

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

所有的标准系统颜色值列表，见：GetSysColor 函数。

3. 当填充矩形的时候，FillRect 函数不会填充矩形的右边和底边，GDI 填充矩形都是如此。


【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。