ExtFloodFill function (wingdi.h)
The ExtFloodFill function fills an area of the display surface with the current brush.
BOOL ExtFloodFill( [in] HDC hdc, [in] int x, [in] int y, [in] COLORREF color, [in] UINT type );
A handle to a device context.
The x-coordinate, in logical units, of the point where filling is to start.
The y-coordinate, in logical units, of the point where filling is to start.
The color of the boundary or of the area to be filled. The interpretation of color depends on the value of the fuFillType parameter. To create a COLORREF color value, use the RGB macro.
The type of fill operation to be performed. This parameter must be one of the following values.
||The fill area is bounded by the color specified by the color parameter. This style is identical to the filling performed by the FloodFill function.|
||The fill area is defined by the color that is specified by color. Filling continues outward in all directions as long as the color is encountered. This style is useful for filling areas with multicolored boundaries.|
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
The 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 color parameter (if FLOODFILLBORDER was requested).
- The specified point does not have the color specified by color (if FLOODFILLSURFACE was requested).
- The point is outside the clipping region, that is, it is not visible on the device.
If fuFillType is FLOODFILLSURFACE, the system 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 color.
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.
For an example, see "Adding Lines and Graphs to a Menu" in Using Menus.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||wingdi.h (include Windows.h)|