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

要执行的填充操作的类型。此参数须为下列值之一。

值	含义
FLOODFILLBORDER	填充区域由 color 参数指定的颜色绑定。此样式与 FloodFill 函数执行的填充相同。
FLOODFILLSURFACE	填充区域由颜色指定的颜色定义。只要遇到颜色，就会沿所有方向继续向外填充。此样式可用于填充具有多色边界的区域。

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

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

下面是此函数可能失败的一些原因：

如果 fuFillType 参数为 FLOODFILLBORDER，则系统假定要填充的区域完全由颜色参数指定的颜色绑定。函数在 nXStart 和 nYStart 参数指定的点开始填充，并沿所有方向继续填充，直到到达边界。

如果 fuFillType 为 FLOODFILLSURFACE，则系统假定要填充的区域是单一颜色。函数开始填充 nXStart 和 nYStart 指定的点处的区域，并沿所有方向继续，填充包含颜色指定颜色的所有相邻区域。

只有内存设备上下文和支持光栅显示操作的设备支持 ExtFloodFill 函数。若要确定设备是否支持此技术，请使用 GetDeviceCaps 函数。

有关示例，请参阅使用菜单中的“将线条和图形添加到菜单”。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll