Funzione ExtFloodFill (wingdi.h)

Articolo
03/08/2023

La funzione ExtFlodFill riempie un'area della superficie di visualizzazione con il pennello corrente.

Sintassi

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

Parametri

[in] hdc

Handle per un contesto di dispositivo.

[in] x

Coordinata x, in unità logiche, del punto in cui iniziare il riempimento.

[in] y

Coordinata y, in unità logiche, del punto in cui iniziare il riempimento.

[in] color

Colore del limite o dell'area da riempire. L'interpretazione del colore dipende dal valore del parametro fuFillType . Per creare un valore di colore COLORREF , usare la macro RGB .

[in] type

Tipo di operazione di riempimento da eseguire. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
FLOODFILLBORDER	L'area di riempimento è associata al colore specificato dal parametro colore . Questo stile è identico al riempimento eseguito dalla funzione FloodFill .
FLOODFILLSURFACE	L'area di riempimento è definita dal colore specificato dal colore. Il riempimento continua verso l'esterno in tutte le direzioni purché venga rilevato il colore. Questo stile è utile per riempire le aree con limiti multicolori.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Di seguito sono riportati alcuni dei motivi per cui questa funzione potrebbe non riuscire:

Impossibile completare il riempimento.
Il punto specificato ha il colore limite specificato dal parametro colore (se è stato richiesto FLOODFILLBORDER).
Il punto specificato non ha il colore specificato in base al colore (se è stato richiesto FLOODFILLSURFACE).
Il punto è esterno all'area di ritaglio, ovvero non è visibile nel dispositivo.

Se il parametro fuFillType è FLOODFILLBORDER, il sistema presuppone che l'area da riempire sia completamente associata al colore specificato dal parametro colore . La funzione inizia il riempimento al punto specificato dai parametri nXStart e nYStart e continua in tutte le direzioni fino a raggiungere il limite.

Se fuFillType è FLOODFILLSURFACE, il sistema presuppone che l'area da riempire sia un singolo colore. La funzione inizia a riempire l'area nel punto specificato da nXStart e nYStart e continua in tutte le direzioni, riempiendo tutte le aree adiacenti contenenti il colore specificato dal colore.

Solo i contesti e i dispositivi di memoria che supportano le operazioni di visualizzazione raster supportano la funzione ExtFlodFill . Per determinare se un dispositivo supporta questa tecnologia, usare la funzione GetDeviceCaps .

Esempio

Per un esempio, vedere "Aggiunta di linee e grafici a un menu" in Uso dei menu.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll