Fungsi ExtSelectClipRgn (wingdi.h)

Artikel
03/08/2023

Fungsi ExtSelectClipRgn menggabungkan wilayah yang ditentukan dengan wilayah kliping saat ini menggunakan mode yang ditentukan.

Sintaks

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] hrgn

Handel ke wilayah yang akan dipilih. Handel ini tidak boleh NULL kecuali mode RGN_COPY ditentukan.

[in] mode

Operasi yang akan dilakukan. Ini harus menjadi salah satu nilai berikut.

Nilai	Makna
RGN_AND	Wilayah kliping baru menggabungkan area tumpang tindih dari wilayah kliping saat ini dan wilayah yang diidentifikasi oleh hrgn.
RGN_COPY	Wilayah kliping baru adalah salinan wilayah yang diidentifikasi oleh hrgn. Ini identik dengan SelectClipRgn. Jika wilayah yang diidentifikasi oleh hrgn adalah NULL, wilayah kliping baru adalah wilayah kliping default (wilayah kliping default adalah wilayah null).
RGN_DIFF	Wilayah kliping baru menggabungkan area wilayah kliping saat ini dengan area yang dikecualikan dari wilayah yang diidentifikasi oleh hrgn.
RGN_OR	Wilayah kliping baru menggabungkan wilayah kliping saat ini dan wilayah yang diidentifikasi oleh hrgn.
RGN_XOR	Wilayah kliping baru menggabungkan wilayah kliping saat ini dan wilayah yang diidentifikasi oleh hrgn tetapi mengecualikan area yang tumpang tindih.

Nilai kembali

Nilai yang dikembalikan menentukan kompleksitas wilayah kliping baru; ini bisa menjadi salah satu nilai berikut.

Menampilkan kode	Deskripsi
NULLREGION	Wilayah kosong.
SIMPLEREGION	Wilayah adalah persegi panjang tunggal.
COMPLEXREGION	Wilayah lebih dari satu persegi panjang.
KESALAHAN	Terjadi kesalahan.

Keterangan

Jika terjadi kesalahan ketika fungsi ini dipanggil, wilayah kliping sebelumnya untuk konteks perangkat yang ditentukan tidak terpengaruh.

Fungsi ExtSelectClipRgn mengasumsikan bahwa koordinat untuk wilayah yang ditentukan ditentukan dalam unit perangkat.

Hanya salinan wilayah yang diidentifikasi oleh parameter hrgn yang digunakan. Wilayah itu sendiri dapat digunakan kembali setelah panggilan ini atau dapat dihapus.

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

Lihat juga

Fungsi Kliping

Gambaran Umum Kliping

PilihClipRgn

Bagikan melalui