IDocumentViewerEvents インターフェイスの OnProgress メソッド

このメソッドはクライアント側で実装されます。Document Viewer のアクティブ ページの解析または認識の実行中に、ABBYY FineReader Engine によって呼び出されます。この処理は、次のいずれかの方法で開始できます。

• Document Viewer のコマンドを使用:
  • MI_Read
  • MI_AnalyzeLayout

これらのコマンドの呼び出し方法については、Document Viewer Commands の一覧を参照してください。

• Document Viewer と同期された Image Viewer の次のコマンドを使用:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

これらのコマンドの呼び出し方法については、Image Viewer Commands の一覧を参照してください。

• Image Viewer と同期された Zoom Viewer の次のコマンドを使用:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

これらのコマンドの呼び出し方法については、Zoom Viewer Commands の一覧を参照してください。

• FineReader Engine API 経由

このメソッドは、処理のおおよその進行率をクライアントに通知します。実装によっては、進行状況インジケーターを表示できます。長時間の処理中にアプリケーションが応答しなくなったように見えるのを防ぐため、システム メッセージを処理してください。これは、ユーザー インターフェイスを備えたアプリケーションで特に有用です。このメソッドを使用して、処理をキャンセルすることもできます。

​

構文

​

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​

C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​

パラメーター

Percentage

[in] 現在の作業の進捗率を示します。値の範囲は 0 ～ 100 です。

Cancel

[out] プロセスを終了する必要があることを示すには、この変数を TRUE に設定します。この場合、解析または認識処理は中止されます。

​

戻り値

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

​

注記

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

​

関連項目

DocumentViewer

IDocumentViewerEvents