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

このメソッドから制御が戻るときに、インクを構成するストロークのコレクションへのポインターが含まれます。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 パラメーターに無効なポインターが含まれていました。
E_INK_EXCEPTION
 メソッド内で例外が発生しました。
E_INVALIDARG
 表示ハンドルが無効です。
E_OUTOFMEMORY
 メモリ操作を割り当てることができません。

要件

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

こちらもご覧ください

HitTest(Point, Single) メソッド

HitTest(Rectangle, Single) メソッド

IInkDisp

InkDisp クラス

InkStrokes コレクション