Metode IInkStrokeDisp::NearestPoint (msinkaut.h)

Menemukan lokasi pada stroke terdekat dengan titik yang diketahui dan mengembalikan jarak titik tersebut dari stroke. Semuanya dalam koordinat ruang tinta.

Sintaks

HRESULT NearestPoint(
  [in]                long  X,
  [in]                long  Y,
  [in, out, optional] float *Distance,
  [out, retval]       float *Point
);

Parameter

[in] X

Posisi x dalam ruang tinta titik untuk diuji.

[in] Y

Posisi y dalam ruang tinta titik untuk diuji.

[in, out, optional] Distance

Opsional. Jarak dari titik ke stroke. Parameter ini bisa NULL. Nilai default adalah 0.

[out, retval] Point

Ketika metode ini kembali, berisi nilai indeks floating point yang mewakili lokasi terdekat pada stroke.

Indeks floating point adalah nilai float yang mewakili lokasi di suatu tempat di antara dua titik dalam goresan. Sebagai contoh, jika 0,0 adalah titik pertama dalam stroke dan 1,0 adalah titik kedua dalam stroke, 0,5 adalah setengah antara poin pertama dan kedua. Demikian pula, nilai indeks floating point 37,25 mewakili lokasi yang 25 persen di sepanjang garis antara titik 37 dan 38 stroke.

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 .

Keterangan

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

Persyaratan

Persyaratan	Nilai
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

Lihat juga

Metode GetRectangleIntersections

Metode HitTest(Point, Single)

Antarmuka IInkStrokeDisp

Metode NearestPoint [Kelas InkDisp]