IInkStrokeDisp::FindIntersections メソッド (msinkaut.h)
この IInkStrokeDisp オブジェクトが既知の InkStrokes コレクション内の他の IInkStrokeDisp オブジェクトと交差するポイントを取得します。
構文
HRESULT FindIntersections(
[in] IInkStrokes *Strokes,
[out, retval] VARIANT *Intersections
);
パラメーター
[in] Strokes
このストロークがコレクション内のストロークと交差するポイントを計算するために使用されるストロークの既知のコレクション。 NULL の場合は、InkDisp オブジェクトのすべてのストロークを使用します。
メモ ストロークの既知のコレクションは、交差をテストするストロークと同じ InkDisp オブジェクトから取得する必要があります。 同じ InkDisp オブジェクトからでない場合は、 E_INK_MISMATCHED_INK_OBJECT が返されます (後述の「HRESULT 値」を参照)。 FindIntersections メソッドは、ストロークの既知のコレクションが同じ InkDisp オブジェクトから取得されることを必要とする唯一のタブレット PC アプリケーション プログラミング インターフェイス (API) です。
[out, retval] Intersections
このメソッドが戻るとき、 には、このストロークがストロークの既知のコレクション内でストロークと交差する位置を示す浮動小数点インデックス値の配列が含まれます。
浮動小数点インデックスは、ストローク内の 2 つのポイント間の位置を表す浮動小数点値です。 例として、0.0 がストロークの最初のポイントで、1.0 がストロークの 2 番目のポイントである場合、0.5 は 1 番目と 2 番目のポイントの中間です。 同様に、浮動小数点インデックス値 37.25 は、ストロークのポイント 37 と 38 の間の線に沿って 25% の位置を表します。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
IInkStrokeDisp ハンドル ヘルパー オブジェクトを割り当てることはできません。 |
|
予期しないパラメーターまたはプロパティの種類。 |
|
メソッド内で例外が発生しました。 |
|
strokes パラメーターは、互換性のある InkDisp オブジェクトを指していません。 |
|
InkStrokes コレクションの InkDisp オブジェクトとこの IInkStrokeDisp オブジェクトが一致しません。 |
解説
このメソッドは、交点のみを決定できます。
要件
| サポートされている最小のクライアント | Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |