IInkStrokeDisp::GetRectangleIntersections メソッド (msinkaut.h)
IInkStrokeDisp オブジェクトが特定の四角形と交差するポイントを検索します。
構文
HRESULT GetRectangleIntersections(
[in] IInkRectangle *Rectangle,
[out, retval] VARIANT *Intersections
);
パラメーター
[in] Rectangle
ヒット テスト領域を表す インク空間 座標の四角形。
[out, retval] Intersections
このメソッドから制御が戻るときに、ストロークが 四角形と交差する場所を示す VARIANT 配列が格納されます。 最初の浮動小数点インデックスは、偶数インデックスに格納されます。 最後の浮動小数点インデックスは奇数インデックスに格納されます。 インデックスの最初のペアは、最初の交差部分を表します。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
Stroke ハンドラー ヘルパー オブジェクトを割り当てることができません。 |
|
予期しないパラメーターまたはプロパティの型。 |
|
メソッド内で例外が発生しました。 |
注釈
このメソッドは、ストロークが指定した四角形と交差する場所を示す配列を返します。 四角形と交差するストロークの各セグメントは、インデックスの 1 つのペアであり、開始インデックスの後に終了インデックスが続きます。
ストロークがテスト四角形内で始まる場合、最初のインデックスは -1 に設定されます。 ストロークがテスト四角形内で終了した場合、最後のインデックスは -1 に設定されます。 ストロークがテスト四角形の外側にある場合は、空の配列が返されます。 たとえば、ストロークがテスト四角形内で始まり、四角形の境界から離れ、内側に戻り、もう一度離れた場合、 GetRectangleIntersections メソッドは {-1,1.4, 5.5, 10.1} を返して、四角形内に収まるストロークの 2 つのセグメントを記述します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |