Fungsi CreateRectRgn (wingdi.h)

Artikel
03/13/2024

Fungsi CreateRectRgn membuat wilayah persegi panjang.

Sintaks

HRGN CreateRectRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

Parameter

[in] x1

Menentukan koordinat x dari sudut kiri atas wilayah dalam unit logis.

[in] y1

Menentukan koordinat y dari sudut kiri atas wilayah dalam unit logis.

[in] x2

Menentukan koordinat x dari sudut kanan bawah wilayah dalam unit logis.

[in] y2

Menentukan koordinat y dari sudut kanan bawah wilayah dalam unit logis.

Nilai kembali

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.

Contoh

Misalnya, lihat Penanda Gambar.

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