Metode IInkDisp::NearestPoint (msinkaut.h)

Artikel
08/24/2023

Mengambil IInkStrokeDisp dalam objek InkDisp yang terdekat dengan titik yang diketahui, secara opsional menyediakan indeks titik terdekat dan jarak ke goresan dari titik yang ditentukan.

Sintaks

HRESULT NearestPoint(
  [in]                long           X,
  [in]                long           Y,
  [in, out, optional] float          *PointOnStroke,
  [in, out, optional] float          *DistanceFromPacket,
  [out, retval]       IInkStrokeDisp **Stroke
);

Parameter

[in] X

Posisi x- dalam ruang tinta titik.

[in] Y

y- Menentukan posisi dalam ruang tinta titik.

[in, out, optional] PointOnStroke

Pilihan. Mengambil titik pada garis goresan yang paling dekat dengan titik yang ditentukan dalam objek InkDisp . Misalnya, nilai 1,5 menunjukkan bahwa titik berada di tengah antara paket stroke pertama dan kedua. Parameter ini bisa NULL. Nilai default adalah 0.

[in, out, optional] DistanceFromPacket

Opsional. Mengambil jarak antara titik yang ditentukan dalam ruang tinta dan goresan terdekat di objek InkDisp . Parameter ini bisa NULL. nilai defaultnya adalah 0.

[out, retval] Stroke

Ketika metode ini kembali, berisi IInkStrokeDisp yang berisi titik yang paling dekat dengan titik yang ditentukan dalam objek InkDisp . Jika lebih dari satu goresan berisi titik yang jaraknya sama dari titik yang ditentukan, nilai hasil ini bersifat arbitrer.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_OUTOFMEMORY	Tidak dapat mengalokasikan operasi memori.

Keterangan

Parameter titik output didefinisikan sebagai angka floating-point karena titik pada garis stroke dapat jatuh di antara dua titik koordinat fisik. Gunakan nilai ini untuk membagi goresan dengan metode Pisahkan , atau bulatkan nilai ke atas atau ke bawah untuk mengindeks paket dalam goresan.

Parameter distanceFromPacket menjelaskan jarak dari titik ke amplop stroke. Ini adalah jarak antara dua titik dikurangi setengah lebar goresan.

Persyaratan


Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll