Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL ExtFloodFill( int x, int y, DWORD crColor, UINT nFillType );
 
  Parameter   Description
 
  <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
              one of the following values:
 
              Value              Meaning
 
              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.
 
  Remarks
 
  Fills an area of the display surface with the current brush. However,
  this member function provides more flexibility than FloodFill. 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.
 
  Return Value
 
  TRUE if the function is successful. FALSE 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.
 
  See Also
 
  ◄CDC::FloodFill►, ◄CDC::GetDeviceCaps►, ◄::ExtFloodFill►
 
 
                                     -♦-