Fungsi CreatePolygonRgn (wingdi.h)

Artikel
08/27/2023

Fungsi CreatePolygonRgn membuat wilayah poligonal.

Sintaks

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Parameter

[in] pptl

Penunjuk ke array struktur POINT yang menentukan simpul poligon dalam unit logis. Poligon dianggap tertutup. Setiap puncak hanya dapat ditentukan sekali.

[in] cPoint

Jumlah titik dalam array.

[in] iMode

Mode isian yang digunakan untuk menentukan piksel mana yang berada di wilayah tersebut. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
ALTERNATIF	Memilih mode alternatif (mengisi area antara sisi poligon bernomor ganjil dan bernomor genap pada setiap baris pemindaian).
BERLIKU	Memilih mode berliku (mengisi wilayah mana pun dengan nilai berliku bukan nol).

Untuk informasi selengkapnya tentang mode ini, lihat fungsi SetPolyFillMode .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke wilayah tersebut.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Saat Anda tidak lagi memerlukan objek HRGN , panggil fungsi DeleteObject untuk menghapusnya.

Koordinat wilayah direpresentasikan sebagai bilangan bulat bertanda tangan 27-bit.

Wilayah yang dibuat oleh metode Buat<bentuk>Rgn (seperti CreateRectRgn dan CreatePolygonRgn) hanya menyertakan interior bentuk; kerangka bentuk dikecualikan dari wilayah tersebut. Ini berarti bahwa setiap titik pada garis antara dua simpul berurutan tidak disertakan dalam wilayah tersebut. Jika Anda memanggil PtInRegion untuk titik tersebut, itu akan mengembalikan nol sebagai hasilnya.

Persyaratan


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