IInkDisp::D eleteStrokes メソッド (msinkaut.h)

InkDisp オブジェクトの Strokes コレクションから InkStrokes コレクションを削除します。

構文

HRESULT DeleteStrokes(
  [in, optional] IInkStrokes *Strokes
);

パラメーター

[in, optional] Strokes

任意。 InkDisp オブジェクトから削除するストロークのコレクションを指定します。 既定値は NULL です。

戻り値

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

リターン コード 説明
S_OK
正常終了しました。
E_POINTER
パラメーターに無効なポインターが含まれていました。
E_OUTOFMEMORY
操作の実行に使用されるメモリを割り当てることができません。
E_FAIL
未指定のエラーが発生しました。
E_INK_MISMATCHED_INK_OBJECT
ストロークの InkDisp オブジェクトは、既知の InkDisp オブジェクトと一致している必要があります。
E_INK_EXCEPTION
メソッド内で例外が発生しました。
E_UNEXPECTED
予期しないパラメーターまたはプロパティの型。

注釈

InkStrokes コレクションが渡されない場合、このメソッドは InkDisp オブジェクト内のすべてのストロークを削除します。 一度に 1 つのストロークのみを削除するには、 DeleteStroke メソッドを呼び出します。

削除されたストロークが InkDisp オブジェクトのストロークコレクションの末尾に収まれていない場合、 InkDisp オブジェクトの残りのストロークのインデックスの番号を け直します。

メモInkStrokes コレクションに含まれるストロークが InkDisp オブジェクトから削除されると、InkStrokes コレクションの内容が無効になります。
 
ユーザーがインクをアクティブに配置しているときに DeleteStrokes が呼び出されると、エラーが発生する可能性があります。

要件

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

こちらもご覧ください

DeleteStroke メソッド

IInkDisp

InkDisp クラス

InkStrokes コレクション