Freigeben über


FloodFill-Funktion (wingdi.h)

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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

COLORREF

ExtFloodFill

RGB