Función ExtFloodFill (wingdi.h)

Artículo
08/27/2023

La función ExtFloodFill rellena un área de la superficie de visualización con el pincel actual.

Sintaxis

BOOL ExtFloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color,
  [in] UINT     type
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo.

[in] x

Coordenada x, en unidades lógicas, del punto donde se va a iniciar el relleno.

[in] y

Coordenada y, en unidades lógicas, del punto donde se va a iniciar el relleno.

[in] color

Color del límite o del área que se va a rellenar. La interpretación del color depende del valor del parámetro fuFillType . Para crear un valor de color COLORREF , use la macro RGB .

[in] type

Tipo de operación de relleno que se va a realizar. Este parámetro puede ser uno de los siguientes valores.

Value	Significado
FLOODFILLBORDER	El área de relleno está limitada por el color especificado por el parámetro de color . Este estilo es idéntico al relleno realizado por la función FloodFill .
FLOODFILLSURFACE	El área de relleno se define mediante el color especificado por color. El relleno continúa hacia afuera en todas las direcciones, siempre y cuando se encuentre el color. Este estilo es útil para rellenar áreas con límites multicolor.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Los siguientes son algunos de los motivos por los que esta función podría producir un error:

No se pudo completar el relleno.
El punto especificado tiene el color de límite especificado por el parámetro de color (si se solicitó FLOODFILLBORDER).
El punto especificado no tiene el color especificado por color (si se solicitó FLOODFILLSURFACE).
El punto está fuera de la región de recorte, es decir, no está visible en el dispositivo.

Si el parámetro fuFillType es FLOODFILLBORDER , el sistema asume que el área que se va a rellenar está completamente limitada por el color especificado por el parámetro color . La función comienza a rellenar en el punto especificado por los parámetros nXStart y nYStart y continúa en todas las direcciones hasta que alcanza el límite.

Si fuFillType es FLOODFILLSURFACE, el sistema asume que el área que se va a rellenar es de un solo color. La función comienza a rellenar el área en el punto especificado por nXStart y nYStart y continúa en todas las direcciones, rellenando todas las regiones adyacentes que contienen el color especificado por color.

Solo los contextos de dispositivo de memoria y los dispositivos que admiten operaciones de visualización ráster admiten la función ExtFloodFill . Para determinar si un dispositivo admite esta tecnología, use la función GetDeviceCaps .

Ejemplos

Para obtener un ejemplo, vea "Agregar líneas y gráficos a un menú" en Usar menús.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll