Metode IInkDisp::NearestPoint (msinkaut.h)
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 |
---|---|
|
Berhasil. |
|
Parameter berisi penunjuk yang tidak valid. |
|
Terjadi kesalahan yang tidak ditentukan. |
|
Pengecualian terjadi di dalam metode . |
|
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 |