> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Windows 上の ABBYY FineReader Engine Visual Components における IImageViewerEvents インターフェイスの OnAnalyzeRegion メソッド — このメソッドはクライアント側で実装されます。

このメソッドはクライアント側で実装されます。[Image Viewer](/ja/fine-reader/engine/visual-components-reference/imageviewer) で [MI\_AnalyzeLayoutInBlock](/ja/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayoutinblock) コマンドが呼び出されて開始されるブロック解析処理の開始前に、ABBYY FineReader Engine によって呼び出されます。このコマンドの呼び出し方法については、[Image Viewer Commands](/ja/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands) の一覧を参照してください。

このメソッドは、これから解析されるRegionに関する情報をクライアントに通知します。また、このメソッドを使用して処理をキャンセルすることもできます。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT OnAnalyzeRegion(
  IRegion*      Region,
  VARIANT_BOOL* Cancel
);
```

### C\#

```csharp theme={null}
void OnAnalyzeRegion(
  IRegion   Region,
  out bool Cancel
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub OnAnalyzeRegion( _
  Region As IRegion, _
  ByRef Cancel As Boolean _
)
```

<div id="parameters">
  ## パラメーター
</div>

Region

\[in] 解析対象となる領域を [Region](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) オブジェクトとして格納します。

Cancel

\[out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、領域は解析されません。

<div id="return-values">
  ## 戻り値
</div>

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

<div id="remarks">
  ## 備考
</div>

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

<div id="see-also">
  ## 関連項目
</div>

[IImageViewerEvents](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents)

[OnAnalyzePage](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzepage-method)

[OnAnalyzeTable](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents/onanalyzetable-method)