Compartilhar via


Função FloodFill (wingdi.h)

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

Confira também

Funções bitmap

Visão geral do Bitmaps

COLORREF

ExtFloodFill

RGB