IInkStrokes::Clip メソッド (msinkaut.h)

  • [アーティクル]

四角形の外側にある IInkStrokeDisp オブジェクトまたは InkStrokes コレクションの一部を削除します。

構文

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

パラメーター

[in] Rectangle

ストロークまたはストロークがクリップされる外側の四角形を指定します。 四角形は、インク空間座標で指定されます。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 パラメーターに無効なポインターが含まれていました。
REGDB_CLASSNOTREG
 InkDisp オブジェクトは登録されていません。
E_INVALIDARG
 クリップの四角形が無効です。
E_INK_EXCEPTION
 メソッド内で例外が発生しました。
E_FAIL
 未指定のエラーが発生しました。

解説

InkDisp オブジェクトの場合、四角形と交差するすべてのストロークが交点で分割されます。 四角形の外側にあるストロークのすべての部分が InkDisp オブジェクトから削除されます。 メソッドは、ストロークが四角形と交差する位置で、ストロークに新しいポイントを追加できます。 InkDisp オブジェクトで Clip メソッドを呼び出すと、InkDisp オブジェクトの strokes コレクション内のストロークの ID は一意であることが保証されますが、他の情報を保持することは保証されません。

このメソッドは、クリッピング時にペンの幅を考慮しません。 実際のインクまたはストローク データのみをクリップします。

IInkStrokeDisp オブジェクトまたは InkStrokes コレクションの場合、Clip メソッドは親 InkDisp オブジェクトを更新します。 InkDisp オブジェクトからインクが削除されるたびに、その InkDisp オブジェクトに対して定義されている IInkStrokeDisp オブジェクトまたは InkStrokes コレクションが無効になる可能性があります。

インク データの詳細については、「 インク データ」を参照してください。

要件

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

こちらもご覧ください

HitTest(Rectangle, Single) メソッド

IInkStrokes

InkRectangle クラス

InkStrokes コレクション