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

# Método OnAnalyzeRegion de la interfaz IImageViewerEvents

> Método OnAnalyzeRegion de la interfaz IImageViewerEvents en ABBYY FineReader Engine Visual Components para Windows — Este método se implementa del lado del cliente.

Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama antes de que comience el proceso de análisis de bloques, que se ha invocado desde [Image Viewer](/es/fine-reader/engine/visual-components-reference/imageviewer) mediante el comando [MI\_AnalyzeLayoutInBlock](/es/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayoutinblock). Para conocer las distintas formas de llamar a este comando, consulte la lista [Image Viewer Commands](/es/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands).

El método proporciona al cliente información sobre la región que se va a analizar. Con este método, es posible cancelar la operación.

<div id="syntax">
  ## Sintaxis
</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">
  ## Parámetros
</div>

Region

\[in] Contiene la región que se va a analizar como objeto [Region](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region).

Cancel

\[out] Puede establecer esta variable en TRUE para indicar que el proceso debe detenerse. En ese caso, la región no se analizará.

<div id="return-values">
  ## Valores de retorno
</div>

\[Solo para C++] Si este método devuelve un valor distinto de S\_OK, indica que se produjo un error del lado del cliente y, en ese caso, no se tiene en cuenta el valor del parámetro Cancel.

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

La implementación cliente de este método debe garantizar que todas las excepciones que se produzcan dentro del método se capturen y se gestionen, y que no se propague ninguna excepción fuera del método. La propagación de una excepción fuera del método puede provocar resultados impredecibles (como la finalización del programa).

<div id="see-also">
  ## Consulte también
</div>

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

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

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