CDC::ExtFloodFill

Fills an area of the display surface with the current brush.

BOOL ExtFloodFill( 
   int x, 
   int y, 
   COLORREF crColor, 
   UINT nFillType  
);

Parameters

  • x
    Specifies the logical x-coordinate of the point where filling begins.

  • y
    Specifies the logical y-coordinate of the point where filling begins.

  • crColor
    Specifies the color of the boundary or of the area to be filled. The interpretation of crColor depends on the value of nFillType.

  • nFillType
    Specifies the type of flood fill to be performed. It must be either of the following values:

    • FLOODFILLBORDER   The fill area is bounded by the color specified by crColor. This style is identical to the filling performed by FloodFill.

    • FLOODFILLSURFACE   The fill area is defined by the color specified by crColor. Filling continues outward in all directions as long as the color is encountered. This style is useful for filling areas with multicolored boundaries.

Return Value

Nonzero if the function is successful; otherwise 0 if the filling could not be completed, if the given point has the boundary color specified by crColor (if FLOODFILLBORDER was requested), if the given point does not have the color specified by crColor (if FLOODFILLSURFACE was requested), or if the point is outside the clipping region.

Remarks

This member function offers more flexibility than FloodFill because you can specify a fill type in nFillType.

If nFillType is set to FLOODFILLBORDER, the area is assumed to be completely bounded by the color specified by crColor. The function begins at the point specified by x and y and fills in all directions to the color boundary.

If nFillType is set to FLOODFILLSURFACE, the function begins at the point specified by x and y and continues in all directions, filling all adjacent areas containing the color specified by crColor.

Only memory-device contexts and devices that support raster-display technology support ExtFloodFill. For more information, see the GetDeviceCaps member function.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::FloodFill

CDC::GetDeviceCaps

ExtFloodFill