FloodFill function (wingdi.h)

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

See also

Bitmap Functions

Bitmaps Overview

COLORREF

ExtFloodFill

RGB