Fungsi SetWindowRgn (winuser.h)

Artikel
01/27/2024

Fungsi SetWindowRgn mengatur wilayah jendela jendela. Wilayah jendela menentukan area di dalam jendela tempat sistem mengizinkan gambar. Sistem tidak menampilkan bagian mana pun dari jendela yang terletak di luar wilayah jendela

Sintaks

int SetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bRedraw
);

Parameter

[in] hWnd

Handel ke jendela yang wilayah jendelanya akan diatur.

[in] hRgn

Handel ke wilayah. Fungsi mengatur wilayah jendela jendela ke wilayah ini.

Jika hRgnNULL, fungsi mengatur wilayah jendela ke NULL.

[in] bRedraw

Menentukan apakah sistem menggambar ulang jendela setelah mengatur wilayah jendela. Jika bRedrawTRUE, sistem melakukannya; jika tidak, itu tidak.

Biasanya, Anda mengatur bRedraw ke TRUE jika jendela terlihat.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Ketika fungsi ini dipanggil, sistem mengirim pesan WM_WINDOWPOSCHANGING dan WM_WINDOWPOSCHANGED ke jendela.

Koordinat wilayah jendela relatif terhadap sudut kiri atas jendela, bukan area klien jendela.

Catatan Jika tata letak jendela kanan-ke-kiri (RTL), koordinat relatif terhadap sudut kanan atas jendela. Lihat Tata Letak Jendela dan Pencerminan.

Setelah panggilan berhasil ke SetWindowRgn, sistem memiliki wilayah yang ditentukan oleh wilayah menangani hRgn. Sistem tidak membuat salinan wilayah. Dengan demikian, Anda tidak boleh melakukan panggilan fungsi lebih lanjut dengan handel wilayah ini. Secara khusus, jangan hapus handel wilayah ini. Sistem menghapus handel wilayah ketika tidak lagi diperlukan.

Untuk mendapatkan wilayah jendela jendela, panggil fungsi GetWindowRgn .

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	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-0 (diperkenalkan dalam Windows 8)