Fungsi CombineRgn (wingdi.h)

Artikel
03/13/2024

Fungsi CombineRgn menggabungkan dua wilayah dan menyimpan hasilnya di wilayah ketiga. Kedua wilayah digabungkan sesuai dengan mode yang ditentukan.

Sintaks

int CombineRgn(
  [in] HRGN hrgnDst,
  [in] HRGN hrgnSrc1,
  [in] HRGN hrgnSrc2,
  [in] int  iMode
);

Parameter

[in] hrgnDst

Handel ke wilayah baru dengan dimensi yang ditentukan dengan menggabungkan dua wilayah lainnya. (Wilayah ini harus ada sebelum CombineRgn dipanggil.)

[in] hrgnSrc1

Handel ke wilayah pertama dari dua wilayah yang akan digabungkan.

[in] hrgnSrc2

Handel ke wilayah kedua dari dua wilayah yang akan digabungkan.

[in] iMode

Mode yang menunjukkan bagaimana kedua wilayah akan digabungkan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
RGN_AND	Membuat persimpangan dua wilayah gabungan.
RGN_COPY	Membuat salinan wilayah yang diidentifikasi oleh hrgnSrc1.
RGN_DIFF	Menggabungkan bagian-bagian hrgnSrc1 yang bukan bagian dari hrgnSrc2.
RGN_OR	Membuat gabungan dua wilayah gabungan.
RGN_XOR	Membuat gabungan dua wilayah gabungan kecuali untuk area yang tumpang tindih.

Nilai kembali

Nilai yang dikembalikan menentukan jenis wilayah yang dihasilkan. Ini bisa menjadi salah satu nilai berikut.

Menampilkan kode	Deskripsi
NULLREGION	Wilayah kosong.
SIMPLEREGION	Wilayah ini adalah persegi panjang tunggal.
COMPLEXREGION	Wilayah ini lebih dari satu persegi panjang.
KESALAHAN	Tidak ada wilayah yang dibuat.

Keterangan

Ketiga wilayah tersebut tidak perlu berbeda. Misalnya, parameter hrgnSrc1 dapat sama dengan parameter hrgnDest .

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