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

IInkStrokeDisp オブジェクトが特定の四角形と交差するポイントを検索します。

構文

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

パラメーター

[in] Rectangle

ヒットテスト領域を表す インク空間 座標の四角形。

[out, retval] Intersections

このメソッドが返されるときに、ストロークが 四角形と交差する場所を示す VARIANT 配列が含まれます。最初の浮動小数点インデックスは、偶数インデックスに格納されます。最後の浮動小数点インデックスは奇数インデックスに格納されます。インデックスの最初のペアは、最初の交差部分を表します。

VARIANT 構造の詳細については、「 COM ライブラリの使用」を参照してください。

値を返す

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

リターンコード	説明
S_OK	成功しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_OUTOFMEMORY	Stroke ハンドラーヘルパーオブジェクトを割り当てることができません。
E_UNEXPECTED	予期しないパラメーターまたはプロパティの型。
E_INK_EXCEPTION	メソッド内で例外が発生しました。

注釈

このメソッドは、ストロークが指定した四角形と交差する場所を示す配列を返します。四角形と交差するストロークの各セグメントは 1 組のインデックスで、開始インデックスと終了インデックスが交互に表示されます。

ストロークがテスト四角形内で始まる場合、最初のインデックスは -1 に設定されます。ストロークがテスト四角形内で終了した場合、最後のインデックスは -1 に設定されます。ストロークがテスト四角形の外側にある場合は、空の配列が返されます。たとえば、ストロークがテスト四角形内で始まり、四角形の境界から離れ、内側に戻り、再び離れる場合、 GetRectangleIntersections メソッドは {-1, 1.4, 5.5, 10.1} を返して、四角形内に入るストロークの 2 つのセグメントを記述します。

必要条件

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