> ## 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éthode OnAnalyzeRegion de l’interface IZoomViewerEvents

> Méthode OnAnalyzeRegion de l’interface IZoomViewerEvents dans les composants visuels d’ABBYY FineReader Engine sous Windows — Cette méthode est implémentée côté client.

Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant le démarrage du processus d’analyse de blocs lancé depuis [Zoom Viewer](/fr/fine-reader/engine/visual-components-reference/zoomviewer) de l’une des façons suivantes :

* l’élément Analyze Layout in Area du menu contextuel est sélectionné
* la commande [MI\_AnalyzeLayoutInBlock](/fr/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_analyzelayoutinblock) est appelée à l’aide de la méthode [DoCommand](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/commands/docommand-method) de IZoomViewer::Commands

Elle transmet au client des informations sur la région qui va être analysée. Cette méthode permet également d’annuler l’opération.

<div id="syntax">
  ## Syntaxe
</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">
  ## Paramètres
</div>

Region

\[in] Contient la région à analyser sous forme d’objet [Region](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region).

Cancel

\[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, la région ne sera pas analysée.

<div id="return-values">
  ## Valeurs de retour
</div>

\[C++ uniquement] Si cette méthode renvoie une valeur autre que S\_OK, cela signifie qu’une erreur s’est produite côté client et, dans ce cas, la valeur du paramètre Cancel n’est pas prise en compte.

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

L’implémentation côté client de cette méthode doit garantir que toutes les exceptions levées dans la méthode sont interceptées et gérées, et qu’aucune exception ne se propage en dehors de la méthode. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (par exemple, l’arrêt du programme).

<div id="see-also">
  ## Voir aussi
</div>

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

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

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