IInkStrokeDisp::NearestPoint メソッド (msinkaut.h)

ストローク上の既知のポイントに最も近い位置を検索し、ストロークからの距離を返します。 すべてがインク空間座標に含まれています。

構文

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

パラメーター

[in] X

テストするポイントのインク空間内の x 位置。

[in] Y

テストするポイントのインク空間内の y 位置。

[in, out, optional] Distance

省略可能。 ポイントからストロークまでの距離。 このパラメーターは、NULL でもかまいません。 既定値は 0 です。

[out, retval] Point

このメソッドが返されるときに、ストロークの最も近い位置を表す浮動小数点インデックス値を格納します。

浮動小数点インデックスは、ストローク内の 2 つのポイント間の位置を表す浮動小数点値です。 例として、0.0 がストロークの最初のポイントで、1.0 がストロークの 2 番目のポイントである場合、0.5 は 1 番目と 2 番目のポイントの中間です。 同様に、浮動小数点インデックス値 37.25 は、ストロークのポイント 37 と 38 の間の線に沿って 25% の位置を表します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	正常終了しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_FAIL	未指定のエラーが発生しました。
E_INK_EXCEPTION	メソッド内で例外が発生しました。

注釈

distance パラメーターは、点からストロークのエンベロープまでの距離を表します。 これは、2 つのポイントからストロークの幅の 2 分の 1 を差し引いた距離です。

要件

要件	値
サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll

こちらもご覧ください

GetRectangleIntersections メソッド

HitTest(Point, Single) メソッド

IInkStrokeDisp インターフェイス

NearestPoint メソッド [InkDisp クラス]