FloodFill-Funktion (wingdi.h)

Artikel
03/04/2024

Die FloodFill-Funktion füllt einen Bereich der Anzeigeoberfläche mit dem aktuellen Pinsel aus. Es wird davon ausgegangen, dass der Bereich gemäß dem Farbparameter begrenzt ist.

Hinweis Die FloodFill-Funktion ist nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows enthalten. Anwendungen sollten die ExtFloodFill-Funktion verwenden, wobei FLOODFILLBORDER angegeben ist.

Syntax

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

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] x

Die x-Koordinate in logischen Einheiten des Punkts, an dem die Füllung beginnen soll.

[in] y

Die y-Koordinate in logischen Einheiten des Punkts, an dem die Füllung beginnen soll.

[in] color

Die Farbe der Begrenzung oder des zu füllenden Bereichs. Um einen COLORREF-Farbwert zu erstellen, verwenden Sie das RGB-Makro .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Im Folgenden finden Sie Gründe, warum diese Funktion fehlschlägt:

Die Füllung konnte nicht abgeschlossen werden.
Der angegebene Punkt weist die durch den Farbparameter angegebene Begrenzungsfarbe auf.
Der angegebene Punkt liegt außerhalb des aktuellen Beschneidungsbereichs, d. h. er ist auf dem Gerät nicht sichtbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll