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

このメソッドはクライアント側で実装されます。Image Viewer から MI_AnalyzeTableStructure コマンドを呼び出して実行されるテーブル構造解析処理の開始前に、ABBYY FineReader Engine によって呼び出されます。このコマンドの呼び出し方法については、Image Viewer Commands の一覧を参照してください。

このメソッドは、これから構造解析されるテーブルブロックのインデックスをクライアントに渡します。このメソッドを使用すると、処理をキャンセルできます。

​

構文

​

C++

HRESULT OnAnalyzeTable(
  int           BlockIndex,
  VARIANT_BOOL* Cancel
);

​

C#

void OnAnalyzeTable(
  int      BlockIndex,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnAnalyzeTable( _
  BlockIndex As Integer, _
  ByRef Cancel As Boolean _
)

​

Parameters

BlockIndex

[in] 分析対象のテーブルブロックのインデックスが格納されます。インデックスは ILayout::VisualBlocks コレクション内にあります。

Cancel

[out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、テーブル構造は分析されません。

​

戻り値

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

​

備考

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

​

関連項目

IImageViewerEvents

OnAnalyzePage

OnAnalyzeRegion