ExtFloodFill
The ExtFloodFill
function fills an area of the display surface with the current brush.
BOOL ExtFloodFill(
|
HDC hdc, |
// handle to device
context |
|
int nXStart, |
// x-coordinate
where filling begins |
|
int nYStart, |
// y-coordinate
where filling begins |
|
COLORREF crColor, |
// fill color |
|
UINT fuFillType |
// fill type |
|
); |
|
Parameters
hdc
Identifies a
device context.
nXStart
Specifies the
logical x-coordinate of the point where filling is to begin.
nYStart
Specifies the
logical y-coordinate of the point where filling is to begin.
crColor
Specifies the
color of the boundary or of the area to be filled. The interpretation of crColor
depends on the value of the fuFillType parameter.
fuFillType
Specifies the
type of fill operation to be performed. It must be one of the following values:
|
Value |
Meaning |
|
FLOODFILLBORDER |
The fill
area is bounded by the color specified by the crColor parameter. This
style is identical to the filling performed by the FloodFill function. |
|
FLOODFILLSURFACE |
The fill
area is defined by the color that is 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 Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
Following are
some of the reasons this function might fail:
The filling could not be
completed.
The specified point has the
boundary color specified by the crColor parameter (if FLOODFILLBORDER
was requested).
The specified point does not
have the color specified by crColor (if FLOODFILLSURFACE was requested).
The point is outside the
clipping region that is,
it is not visible on the device.
If the fuFillType
parameter is FLOODFILLBORDER, Windows assumes that the area to be filled is
completely bounded by the color specified by the crColor parameter. The
function begins filling at the point specified by the nXStart and nYStart
parameters and continues in all directions until it reaches the boundary.
If fuFillType
is FLOODFILLSURFACE, Windows assumes that the area to be filled is a single
color. The function begins to fill the area at the point specified by nXStart
and nYStart and continues in all directions, filling all adjacent
regions containing the color specified by crColor.
Only memory
device contexts and devices that support raster-display operations support the ExtFloodFill
function. To determine whether a device supports this technology, use the GetDeviceCaps
function.
See Also