Fungsi PtInRect (winuser.h)

Artikel
08/27/2023

Fungsi PtInRect menentukan apakah titik yang ditentukan terletak dalam persegi panjang yang ditentukan. Titik berada dalam persegi panjang jika terletak di sisi kiri atau atas atau berada di keempat sisi. Titik di sisi kanan atau bawah dianggap di luar persegi panjang.

Sintaks

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

Parameter

[in] lprc

Penunjuk ke struktur RECT yang berisi persegi panjang yang ditentukan.

[in] pt

Struktur POINT yang berisi titik yang ditentukan.

Menampilkan nilai

Jika titik yang ditentukan terletak di dalam persegi panjang, nilai yang dikembalikan bukan nol.

Jika titik yang ditentukan tidak terletak di dalam persegi panjang, nilai yang dikembalikan adalah nol.

Keterangan

Persegi panjang harus dinormalisasi sebelum PtInRect dipanggil. Artinya, lprc.right harus lebih besar dari lprc.left dan lprc.bottom harus lebih besar dari lprc.top. Jika persegi panjang tidak dinormalisasi, titik tidak pernah dianggap di dalam persegi panjang.

Karena aplikasi dapat menggunakan persegi panjang untuk tujuan yang berbeda, fungsi persegi panjang tidak menggunakan satuan ukuran eksplisit. Sebaliknya, semua koordinat dan dimensi persegi panjang diberikan dalam nilai logika yang ditandatangani. Mode pemetaan dan fungsi di mana persegi panjang digunakan menentukan unit pengukuran.

Contoh

Misalnya, lihat Menggunakan Persegi Panjang.

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