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

> Método OnAnalyzeRegion de la interfaz IZoomViewerEvents 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 se inicie el proceso de análisis de bloques, que se ha invocado desde [Zoom Viewer](/es/fine-reader/engine/visual-components-reference/zoomviewer) de una de las siguientes formas:

* Se selecciona el elemento Analyze Layout in Area del menú contextual
* Se llama al comando [MI\_AnalyzeLayoutInBlock](/es/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_analyzelayoutinblock) mediante el método [DoCommand](/es/fine-reader/engine/visual-components-reference/supplementary-objects/commands/docommand-method) de IZoomViewer::Commands

Este método proporciona al cliente información sobre la región que se va a analizar. También permite 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 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 terminarse. En este caso, la región no se analizará.

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

\[Solo C++] Si este método devuelve un valor distinto de S\_OK, significa 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 gestionen, y que ninguna se propague fuera del método. La propagación de una excepción fuera del método puede dar lugar a resultados impredecibles (como la terminación del programa).

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

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

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

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