ExtFloodFill function

The ExtFloodFill function fills an area of the display surface with the current brush.

Syntax

C++

BOOL ExtFloodFill(

  _In_  HDC hdc,

  _In_  int nXStart,

  _In_  int nYStart,

  _In_  COLORREF crColor,

  _In_  UINT fuFillType

);

Parameters

hdc [in]

A handle to a device context.

nXStart [in]

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

nYStart [in]

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

crColor [in]

The color of the boundary or of the area to be filled. The interpretation of crColor depends on the value of thefuFillType parameter. To create a COLORREF color value, use the RGB macro.

fuFillType [in]

The type of fill operation to be performed. This parameter must be one of the following values.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

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 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 regionthat is, it is not visible on the device.

If the fuFillType parameter is FLOODFILLBORDER, the system 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 andnYStart parameters and continues in all directions until it reaches the boundary.

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 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.

Examples

For an example, see "Adding Lines and Graphs to a Menu" in Using Menus.

Requirements

See also

Bitmaps Overview

Bitmap Functions

FloodFill

GetDeviceCaps

COLORREF

RGB

可以用来填充不规则区域

ExtFloodFill 可以填充不规则区域