IImageViewerEvents インターフェイスの OnDeleteBlocks メソッド

このメソッドはクライアント側で実装されます。次のいずれかの方法で処理が開始された場合、ABBYY FineReader Engine は Image Viewer 内のブロックを削除する前にこのメソッドを呼び出します。

コマンドの呼び出し方法については、Image Viewer Commands の一覧を参照してください。このメソッドは、削除予定のブロックのインデックスをクライアントに渡します。このメソッドを使用すると、この操作をキャンセルできます。

構文

HRESULT OnDeleteBlocks(
  IIntsCollection* BlocksToDelete,
  VARIANT_BOOL*    Cancel
);

void OnDeleteBlocks(
  IIntsCollection BlocksToDelete,
  out bool        Cancel
);

Sub OnDeleteBlocks( _
  BlocksToDelete As IIntsCollection, _
  ByRef Cancel As Boolean _
)

BlocksToDelete [in] 削除するブロックのインデックスを、IntsCollection オブジェクトとして格納します。 Cancel [out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、ブロックは削除されません。

[C++ のみ] このメソッドが S_OK 以外の値を返した場合は、クライアント側でエラーが発生したことを示します。この場合、Cancel パラメーターの値は考慮されません。

このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を確実にキャッチして処理し、例外がメソッドの外に伝播しないようにする必要があります。例外がメソッドの外に伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。