Fungsi EvaluateProximityToRect (winuser.h)

  • Artikel

Mengembalikan skor persegi sebagai target sentuhan yang mungkin, dibandingkan dengan semua persegi lainnya yang bersinggungan dengan area kontak sentuh, dan titik sentuh yang disesuaikan dalam persegi panjang.

Sintaks

BOOL EvaluateProximityToRect(
  [in]  const RECT                             *controlBoundingBox,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Parameter

[in] controlBoundingBox

Struktur RECT yang menentukan kotak pembatas elemen UI.

[in] pHitTestingInput

Struktur TOUCH_HIT_TESTING_INPUT yang menyimpan data untuk area kontak sentuh.

[out] pProximityEval

Struktur TOUCH_HIT_TESTING_PROXIMITY_EVALUATION yang menyimpan skor dan menyesuaikan data titik sentuh.

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan TRUE.

Jika tidak, ia mengembalikan FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Untuk konsistensi dengan Windows, kerangka kerja yang menangani WM_TOUCHHITTESTING harus menggunakan prinsip-prinsip berikut untuk penargetan:

  • Penyertaan: Jika titik sentuh berada dalam batas kontrol, titik sentuh tidak diubah.
  • Persimpangan: Sertakan hanya kontrol yang bersinggungan dengan geometri kontak.
  • Urutan Z: Jika lebih dari satu kontrol berpotongan geometri kontak, dan kontrol tumpang tindih, kontrol yang tertinggi dalam urutan z menerima prioritas.
  • Ambiguitas: Jika lebih dari satu kontrol berpotongan geometri kontak, dan kontrol tidak tumpang tindih, kontrol yang paling dekat dengan titik sentuh asli menerima prioritas.

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Tidak ada yang didukung
Target Platform Windows
Header winuser.h
Pustaka User32.lib
DLL User32.dll

Lihat juga

Fungsi