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% の位置を表します。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
未指定のエラーが発生しました。 |
|
メソッド内で例外が発生しました。 |
注釈
distance パラメーターは、点からストロークのエンベロープまでの距離を表します。 これは、2 つのポイントからストロークの幅の 2 分の 1 を差し引いた距離です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |