IInkDisp::ExtractWithRectangle メソッド (msinkaut.h)
既存の 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 オブジェクトへのポインターを格納します。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
すべてのストロークが抽出されたわけではありません。 |
|
操作を完了するためにメモリを割り当てることができません。 |
|
抽出フラグが無効です。 |
|
Ink オブジェクトが登録されていません。 |
注釈
新しい InkDisp オブジェクトは、元の InkDisp オブジェクトの描画属性、プロパティ、および座標を保持します。
このメソッドは、元のオブジェクトからストロークを削除または切り取ることなく、新しい InkDisp オブジェクトを作成する場合に便利です。
ストロークの既知のコレクションからストロークを抽出するには、 ExtractStrokes メソッドを呼び出します。
四角形内にあるストロークの部分のみが、新しい InkDisp オブジェクトに追加されます。
extractFlags パラメーターが RemoveFromOriginal または Default の場合、四角形を横切るストロークはすべて分割され、四角形内の部分は既存の InkDisp オブジェクトから削除されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |