extFloodFill 函数 (wingdi.h)
ExtFloodFill 函数使用当前画笔填充显示图面的一个区域。
语法
BOOL ExtFloodFill(
[in] HDC hdc,
[in] int x,
[in] int y,
[in] COLORREF color,
[in] UINT type
);
参数
[in] hdc
设备上下文的句柄。
[in] x
要开始填充的点的 x 坐标(以逻辑单位为单位)。
[in] y
开始填充的点的 y 坐标(以逻辑单位为单位)。
[in] color
要填充的边界或区域的颜色。 颜色的解释取决于 fuFillType 参数的值。 若要创建 COLORREF 颜色值,请使用 RGB 宏。
[in] type
要执行的填充操作的类型。 此参数须为下列值之一。
值 | 含义 |
---|---|
|
填充区域由 color 参数指定的颜色绑定。 此样式与 FloodFill 函数执行的填充相同。 |
|
填充区域由颜色指定的 颜色定义。 只要遇到颜色,就会沿所有方向继续向外填充。 此样式可用于填充具有多色边界的区域。 |
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。
注解
下面是此函数可能失败的一些原因:
- 无法完成填充。
- 如果) 请求 FLOODFILLBORDER,则指定的点具有 颜色 参数指定的边界颜色 (。
- 如果) 请求 FLOODFILLSURFACE,则指定的点没有 颜色 (指定的颜色。
- 该点位于剪辑区域之外,也就是说,它在设备上不可见。
如果 fuFillType 为 FLOODFILLSURFACE,则系统假定要填充的区域是单一颜色。 函数开始填充 nXStart 和 nYStart 指定的点处的区域,并沿所有方向继续,填充包含 颜色指定颜色的所有相邻区域。
只有内存设备上下文和支持光栅显示操作的设备支持 ExtFloodFill 函数。 若要确定设备是否支持此技术,请使用 GetDeviceCaps 函数。
示例
有关示例,请参阅 使用菜单中的“将线条和图形添加到菜单”。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |