Fungsi EvaluateProximityToPolygon (winuser.h)

  • Artikel

Mengembalikan skor poligon sebagai target sentuhan yang mungkin (dibandingkan dengan semua poligon lain yang bersinggungan dengan area kontak sentuh) dan titik sentuh yang disesuaikan dalam poligon.

Sintaks

BOOL EvaluateProximityToPolygon(
        UINT32                                 numVertices,
  [in]  const POINT                            *controlPolygon,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Parameter

numVertices

Jumlah simpul dalam poligon. Nilai ini harus lebih besar dari atau sama dengan 3.

Nilai ini menunjukkan ukuran array, seperti yang ditentukan oleh parameter controlPolygon .

[in] controlPolygon

Array koordinat layar x-y yang menentukan bentuk elemen UI.

Parameter numVertices menentukan jumlah koordinat.

[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.

Nilai kembali

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

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus 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