IInkDisp::ExtractWithRectangle メソッド (msinkaut.h)

[アーティクル]
02/29/2024

既存の InkDisp オブジェクトからストロークを切り取るかコピーし、既知の四角形を使用して抽出するストロークを決定することで、新しい InkDisp オブジェクトに貼り付けます。

構文

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

パラメーター

[in] Rectangle

InkDisp オブジェクトから抽出するインクを区切る InkRectangle オブジェクトを指定します。

[in, optional] extractFlags

省略可能。 InkExtractFlags 列挙型を指定します。これにより、インクを既存の InkDisp オブジェクトから切り取るかコピーするかを決定します。既定値は IEF_DEFAULT で、既存の InkDisp オブジェクトからストロークをカットします。

[out, retval] ExtractedInk

このメソッドが戻るときに、ストロークの抽出されたコレクションを含む InkDisp オブジェクトへのポインターを格納します。

戻り値

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

リターンコード	説明
S_OK	正常終了しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_INK_EXCEPTION	メソッド内で例外が発生しました。
E_INK_SOME_STROKES_NOT_EXTRACTED	すべてのストロークが抽出されたわけではありません。
E_OUTOFMEMORY	操作を完了するためにメモリを割り当てることができません。
E_INVALIDARG	抽出フラグが無効です。
REGDB_CLASSNOTREG	Ink オブジェクトが登録されていません。

注釈

新しい InkDisp オブジェクトは、元の InkDisp オブジェクトの描画属性、プロパティ、および座標を保持します。

このメソッドは、元のオブジェクトからストロークを削除または切り取ることなく、新しい InkDisp オブジェクトを作成する場合に便利です。

ストロークの既知のコレクションからストロークを抽出するには、 ExtractStrokes メソッドを呼び出します。

四角形内にあるストロークの部分のみが、新しい InkDisp オブジェクトに追加されます。

extractFlags パラメーターが RemoveFromOriginal または Default の場合、四角形を横切るストロークはすべて分割され、四角形内の部分は既存の InkDisp オブジェクトから削除されます。

要件

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