Função ExtFloodFill (wingdi.h)

Artigo
03/08/2023

A função ExtFloodFill preenche uma área da superfície de exibição com o pincel atual.

Sintaxe

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

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. A interpretação da cor depende do valor do parâmetro fuFillType . Para criar um valor de cor COLORREF , use a macro RGB .

[in] type

O tipo de operação de preenchimento a ser executada. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
FLOODFILLBORDER	A área de preenchimento é limitada pela cor especificada pelo parâmetro de cor . Esse estilo é idêntico ao preenchimento executado pela função FloodFill .
FLOODFILLSURFACE	A área de preenchimento é definida pela cor especificada por cor. O preenchimento continua para fora em todas as direções, desde que a cor seja encontrada. Esse estilo é útil para preencher áreas com limites com várias cores.

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 alguns dos 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 (se FLOODFILLBORDER foi solicitado).
O ponto especificado não tem a cor especificada por cor (se FLOODFILLSURFACE foi solicitado).
O ponto está fora da região de recorte, ou seja, não está visível no dispositivo.

Se o parâmetro fuFillType for FLOODFILLBORDER, o sistema pressupõe que a área a ser preenchida seja completamente limitada pela cor especificada pelo parâmetro de cor . A função começa a ser preenchida no ponto especificado pelos parâmetros nXStart e nYStart e continua em todas as direções até atingir o limite.

Se fuFillType for FLOODFILLSURFACE, o sistema pressupõe que a área a ser preenchida seja uma única cor. A função começa a preencher a área no ponto especificado por nXStart e nYStart e continua em todas as direções, preenchendo todas as regiões adjacentes que contêm a cor especificada por cor.

Somente os contextos e dispositivos de dispositivo de memória que dão suporte a operações de exibição de raster dão suporte à função ExtFloodFill . Para determinar se um dispositivo dá suporte a essa tecnologia, use a função GetDeviceCaps .

Exemplos

Para obter um exemplo, confira "Como adicionar linhas e grafos a um menu" em Usando menus.

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