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

# Methode OnAnalyzeRegion der IZoomViewerEvents-Schnittstelle

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

Diese Methode ist clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor dem Start des Blockanalyseprozesses aufgerufen, der im [Zoom Viewer](/de/fine-reader/engine/visual-components-reference/zoomviewer) auf eine der folgenden Arten gestartet wurde:

* Im Kontextmenü wird der Eintrag Analyze Layout in Area ausgewählt
* Der Befehl [MI\_AnalyzeLayoutInBlock](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_analyzelayoutinblock) wird über die Methode [DoCommand](/de/fine-reader/engine/visual-components-reference/supplementary-objects/commands/docommand-method) von IZoomViewer::Commands aufgerufen

Sie liefert 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 zu analysierende Region als [Region](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)-Objekt.

Cancel

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

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

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

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

Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen 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>

[IZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents)

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

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