Fungsi ExtFloodFill (wingdi.h)

Artikel
03/13/2024

Fungsi ExtFloodFill mengisi area permukaan tampilan dengan kuas saat ini.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x, dalam unit logis, dari titik di mana pengisian akan dimulai.

[in] y

Koordinat y, dalam unit logis, dari titik di mana pengisian akan dimulai.

[in] color

Warna batas atau area yang akan diisi. Interpretasi warna tergantung pada nilai parameter fuFillType . Untuk membuat nilai warna COLORREF , gunakan makro RGB .

[in] type

Jenis operasi pengisian yang akan dilakukan. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Makna
FLOODFILLBORDER	Area isian dibatasi oleh warna yang ditentukan oleh parameter warna . Gaya ini identik dengan pengisian yang dilakukan oleh fungsi FloodFill .
FLOODFILLSURFACE	Area isian ditentukan oleh warna yang ditentukan oleh warna. Pengisian berlanjut ke luar ke semua arah selama warna ditemui. Gaya ini berguna untuk mengisi area dengan batas multiwarna.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Berikut ini adalah beberapa alasan fungsi ini mungkin gagal:

Pengisian tidak dapat diselesaikan.
Titik yang ditentukan memiliki warna batas yang ditentukan oleh parameter warna (jika FLOODFILLBORDER diminta).
Titik yang ditentukan tidak memiliki warna yang ditentukan oleh warna (jika FLOODFILLSURFACE diminta).
Titik berada di luar wilayah kliping, yaitu, tidak terlihat pada perangkat.

Jika parameter fuFillType adalah FLOODFILLBORDER, sistem mengasumsikan bahwa area yang akan diisi benar-benar dibatasi oleh warna yang ditentukan oleh parameter warna . Fungsi mulai mengisi pada titik yang ditentukan oleh parameter nXStart dan nYStart dan berlanjut ke semua arah sampai mencapai batas.

Jika fuFillType adalah FLOODFILLSURFACE, sistem mengasumsikan bahwa area yang akan diisi adalah satu warna. Fungsi mulai mengisi area pada titik yang ditentukan oleh nXStart dan nYStart dan berlanjut ke semua arah, mengisi semua wilayah yang berdampingan yang berisi warna yang ditentukan oleh warna.

Hanya konteks perangkat memori dan perangkat yang mendukung operasi raster-display yang mendukung fungsi ExtFloodFill . Untuk menentukan apakah perangkat mendukung teknologi ini, gunakan fungsi GetDeviceCaps .

Contoh

Misalnya, lihat "Menambahkan Garis dan Grafik ke Menu" di Menggunakan Menu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll