wingdi.h


ExtFloodFill

La función ExtFloodFill rellena un área del display usando el pincel actual.

Sintaxis

BOOL ExtFloodFill(
    HDC hdc,          // manipulador de contexto de dispositivo
    int nXStart,      // coordenada x donde empieza el llenado
    int nYStart,      // coordenada y donde empieza el llenado
    COLORREF crColor, // color de llenado
    UINT fuFillType   // tipo de llenado
   );

Parámetros

hdc: identifica un contexto de dispositivo.

nXStart: especifica la coordenada x lógica del punto donde se comienza el llenado.

nYStart: especifica la coordenada y lógica del punto donde se comienza el llenado.

crColor: especifica el color del borde o del área a rellenar. La interpretación de crColor depende del valor del parámetro fuFillType.

fuFillType: especifica el tipo de operación de llenado a realizar. Debe ser uno de los siguientes valores:

Valor Significado
FLOODFILLBORDER El área a rellenar está bordeada por el color especificado en el parámetro crColor. Este estilo es idéntico que el llenado realizado por la función FloodFill.
FLOODFILLSURFACE El área a rellenar se define por el color especificado en el parámetro crColor. El llenado continúa por fuera en todas las direcciones en las que se encuentre el color. Este estilo es habitual para rellenar áreas con bordes de varios colores.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener información complementaria de error, llamar a la función GetLastError

Observaciones

Estas son algunas razones por las que esta función puede fallar:

  • El llenado no puede ser completado.
  • El punto dado tiene el color especificado por el parámetro crColor (si se ha especificado el tipo FLOODFILLBORDER).
  • El punto dado no tiene el color especificado por el parámetro crColor (si se ha especificado el tipo FLOODFILLSURFACE).
  • El punto especificado está fuera de la región de recorte, es decir, no es visible dentro del dispositivo.

Si el parámetro fuFillType es FLOODFILLBORDER, Windows asume que el área a rellenar está completamente bordeada por el color especificado por el parámetro crColor. La función empieza a rellenar en el punto especificado por los parámetros nXStart y nYStart y continúa en todas direcciones mientras no encuentre el borde.

Si fuFillType es FLOODFILLSURFACE, Windows asume que el área a rellenar es un único color. La función empieza a rellenar el área en el punto especificado por los parámetros nXStart y nYStart y continúa en todas direcciones, rellenando todas las regiones adyacentes que contengan el color especificado por crColor.

Sólo contextos de dispositivo de memoria y dispositivos que soporten operaciones de rastreo soportan la función ExtFloodFill. Para determinar si un dispositivo soporta esta tecnología, usar la función GetDeviceCaps.