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

> Méthode OnAnalyzeRegion de l’interface IImageViewerEvents dans ABBYY FineReader Engine Visual Components 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ébut du processus d’analyse de blocs, lancé depuis [Image Viewer](/fr/fine-reader/engine/visual-components-reference/imageviewer) à l’aide de la commande [MI\_AnalyzeLayoutInBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayoutinblock). Pour connaître les différentes façons d’appeler cette commande, consultez la liste des [Image Viewer Commands](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands).

La méthode fournit au client des informations sur la région qui va être analysée. Elle 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 indique 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 cliente de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et traitées, et qu’aucune ne se propage à l’extérieur 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>

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

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

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