Fungsi GetRandomRgn (wingdi.h)

Fungsi GetRandomRgn menyalin wilayah kliping sistem dari konteks perangkat tertentu ke wilayah tertentu.

Sintaks

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] hrgn

Handel ke suatu wilayah. Sebelum fungsi dipanggil, ini mengidentifikasi wilayah yang ada. Setelah fungsi kembali, ini mengidentifikasi salinan wilayah sistem saat ini. Wilayah lama yang diidentifikasi oleh hrgn ditimpa.

[in] i

Parameter ini harus SYSRGN.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah 1. Jika fungsi gagal, nilai yang dikembalikan adalah -1. Jika wilayah yang akan diambil adalah NULL, nilai yang dikembalikan adalah 0. Jika fungsi gagal atau wilayah yang akan diambil adalah NULL, hrgn tidak diinisialisasi.

Keterangan

Saat menggunakan bendera SYSRGN, perhatikan bahwa wilayah kliping sistem mungkin tidak terkini karena pergerakan jendela. Meskipun demikian, aman untuk mengambil dan menggunakan wilayah kliping sistem dalam blok BeginPaint-EndPaint selama pemrosesan WM_PAINT . Dalam hal ini, wilayah sistem adalah persimpangan wilayah pembaruan dan area jendela yang terlihat saat ini. Setiap pergerakan jendela setelah pengembalian GetRandomRgn dan sebelum EndPaint akan menghasilkan pesan WM_PAINT baru. Penggunaan bendera SYSRGN lainnya dapat mengakibatkan kesalahan pengecatan dalam aplikasi Anda.

Wilayah yang dikembalikan berada dalam koordinat layar.

Persyaratan

Lihat juga

BeginPaint

Fungsi Kliping

Gambaran Umum Kliping

EndPaint

ExtSelectClipRgn

GetClipBox

GetClipRgn

GetRegionData

OffsetRgn