Função FloodFill (wingdi.h)

Artigo
03/13/2024

A função FloodFill preenche uma área da superfície de exibição com o pincel atual. Supõe-se que a área seja associada conforme especificado pelo parâmetro de cor .

Nota A função FloodFill é incluída apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função ExtFloodFill com FLOODFILLBORDER especificado.

Sintaxe

BOOL FloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Parâmetros

[in] hdc

Um identificador para um contexto de dispositivo.

[in] x

A coordenada x, em unidades lógicas, do ponto em que o preenchimento deve ser iniciado.

[in] y

A coordenada y, em unidades lógicas, do ponto em que o preenchimento deve ser iniciado.

[in] color

A cor do limite ou da área a ser preenchida. Para criar um valor de cor COLORREF , use a macro RGB .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Veja a seguir os motivos pelos quais essa função pode falhar:

Não foi possível concluir o preenchimento.
O ponto especificado tem a cor de limite especificada pelo parâmetro de cor .
O ponto determinado está fora da região de recorte atual, ou seja, não está visível no dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll