> ## 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.

# OnAnalyzeRegion-Methode der IImageViewerEvents-Schnittstelle

> OnAnalyzeRegion-Methode der IImageViewerEvents-Schnittstelle in ABBYY FineReader Engine Visual Components unter Windows — Diese Methode wird clientseitig implementiert.

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor dem Start der Blockanalyse aufgerufen, die im [Image Viewer](/de/fine-reader/engine/visual-components-reference/imageviewer) durch Aufrufen des Befehls [MI\_AnalyzeLayoutInBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayoutinblock) gestartet wurde. Welche Möglichkeiten es gibt, diesen Befehl aufzurufen, finden Sie in der Liste [Image Viewer Commands](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands).

Die Methode übergibt dem Client Informationen über die Region, die analysiert werden soll. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

<div id="syntax">
  ## 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">
  ## Parameter
</div>

Region

\[in] Enthält die Region, die als [Region](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)-Objekt analysiert werden soll.

Cancel

\[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang beendet werden soll. In diesem Fall wird die Region nicht analysiert.

<div id="return-values">
  ## Rückgabewerte
</div>

\[Nur in C++] Wenn diese Methode einen anderen Wert als S\_OK zurückgibt, bedeutet das, dass clientseitig ein Fehler aufgetreten ist. In diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.

<div id="remarks">
  ## Bemerkungen
</div>

Die Clientimplementierung dieser Methode muss sicherstellen, dass alle Ausnahmen, die innerhalb der Methode ausgelöst werden, abgefangen und behandelt werden und dass keine Ausnahmen über die Methode hinaus weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).

<div id="see-also">
  ## Siehe auch
</div>

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

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

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