ExtFloodFill-Funktion (wingdi.h)

Artikel
03/04/2024

Die ExtFloodFill-Funktion füllt einen Bereich der Anzeigeoberfläche mit dem aktuellen Pinsel aus.

Syntax

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

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] x

Die x-Koordinate in logischen Einheiten des Punkts, an dem die Befü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 Grenze oder des zu füllenden Bereichs. Die Interpretation der Farbe hängt vom Wert des fuFillType-Parameters ab. Verwenden Sie das RGB-Makro, um einen COLORREF-Farbwert zu erstellen.

[in] type

Der Typ des auszuführenden Füllvorgangs. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
FLOODFILLBORDER	Der Füllbereich wird durch die Farbe begrenzt, die durch den Farbparameter angegeben wird. Dieser Stil ist identisch mit der Füllung, die von der FloodFill-Funktion ausgeführt wird.
FLOODFILLSURFACE	Der Füllbereich wird durch die Farbe definiert, die durch Farbe angegeben wird. Die Füllung wird in alle Richtungen fortgesetzt, solange die Farbe gefunden wird. Dieser Stil ist nützlich, um Bereiche mit mehrfarbigen Begrenzungen zu füllen.

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 sind einige der Gründe aufgeführt, warum diese Funktion fehlschlägt:

Die Befüllung konnte nicht abgeschlossen werden.
Der angegebene Punkt weist die durch den Farbparameter angegebene Begrenzungsfarbe auf (wenn FLOODFILLBORDER angefordert wurde).
Der angegebene Punkt verfügt nicht über die farbe angegebene Farbe (wenn FLOODFILLSURFACE angefordert wurde).
Der Punkt befindet sich außerhalb des Beschneidungsbereichs, d. h. er ist auf dem Gerät nicht sichtbar.

Wenn der fuFillType-Parameter FLOODFILLBORDER lautet, geht das System davon aus, dass der zu füllende Bereich vollständig durch die durch den Farbparameter angegebene Farbe begrenzt ist. Die Funktion beginnt an dem durch die Parameter nXStart und nYStart angegebenen Punkt zu füllen und fährt in alle Richtungen fort, bis sie die Grenze erreicht.

Wenn fuFillType auf FLOODFILLSURFACE festgelegt ist, geht das System davon aus, dass der zu füllende Bereich eine einzelne Farbe hat. Die Funktion beginnt mit dem Ausfüllen des Bereichs an der durch nXStart und nYStart angegebenen Stelle und setzt sich in alle Richtungen fort und füllt alle angrenzenden Bereiche aus, die die durch Farbe angegebene Farbe enthalten.

Nur Speichergerätekontexte und Geräte, die Rasteranzeigevorgänge unterstützen, unterstützen die ExtFloodFill-Funktion . Verwenden Sie die GetDeviceCaps-Funktion , um festzustellen, ob ein Gerät diese Technologie unterstützt.

Beispiele

Ein Beispiel finden Sie unter Hinzufügen von Linien und Diagrammen zu einem Menü unter Verwenden von Menüs.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll