IInkDisp::HitTestWithLasso メソッド (msinkaut.h)
ポリライン選択領域内のストロークを取得します。
構文
HRESULT HitTestWithLasso(
[in] VARIANT Points,
[in] float IntersectPercent,
[in, out, optional] VARIANT *LassoPoints,
[out, retval] IInkStrokes **Strokes
);
パラメーター
[in] Points
ストロークを選択するために選択ツールで使用されるポイント。 選択領域は、境界が最初にそれ自体と交差する選択境界内の領域です。 境界がそれ自体と交差しない場合、 メソッドは配列の末尾に点を追加して、最初の点から最後の点までの直線を作成します。 境界が直線 (選択境界内の領域なし) の場合、ストロークは選択されません。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
[in] IntersectPercent
ストロークの結果のコレクションにストロークを含めるには、選択ツール内に含める必要があるストローク ポイントの割合。 0 (0
) の場合、選択ツール内または選択ツールで交差するすべてのストロークが、結果のストロークのコレクションに含まれます。 100 の場合、選択ツールに完全に含まれるストロークのみがコレクションに含まれます。 選択ツールに含まれるストロークのポイントの割合が percentIntersect のパーセンテージ以上の場合、選択ツールと交差するストロークがコレクションに含まれます。 小数部のパーセンテージは切り上げられます。
[in, out, optional] LassoPoints
省略可能。 選択範囲に使用される選択ツールの特定の部分を取得します。 ユーザーはさまざまな種類の選択ツールを描画でき、そのうちの一部は複数回重なっているため、選択ツールのどの部分が選択に使用されたかを示す場合に便利です。 既定値は NULL ポインターです。これは、情報が返されていないことを意味します。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
[out, retval] Strokes
このメソッドから制御が戻るときに、インクを構成するストロークのコレクションへのポインターが含まれます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
表示ハンドルが無効です。 |
|
メモリ操作を割り当てることができません。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | msinkaut.h |
Library | InkObj.dll |