FloodFill function (wingdi.h)

Article
02/22/2024

The FloodFill function fills an area of the display surface with the current brush. The area is assumed to be bounded as specified by the color parameter.

Note The FloodFill function is included only for compatibility with 16-bit versions of Windows. Applications should use the ExtFloodFill function with FLOODFILLBORDER specified.

Syntax

BOOL FloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Parameters

[in] hdc

A handle to a device context.

[in] x

The x-coordinate, in logical units, of the point where filling is to start.

[in] y

The y-coordinate, in logical units, of the point where filling is to start.

[in] color

The color of the boundary or the area to be filled. To create a COLORREF color value, use the RGB macro.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The following are reasons this function might fail:

The fill could not be completed.
The given point has the boundary color specified by the color parameter.
The given point lies outside the current clipping region, that is, it is not visible on the device.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll