> ## 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 OnToolAddBlock de l’interface IZoomViewerEvents

> Méthode OnToolAddBlock de l’interface IZoomViewerEvents dans les Visual Components 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 l’ajout d’un nouveau bloc tracé dans [Zoom Viewer](/fr/fine-reader/engine/visual-components-reference/zoomviewer) à l’aide de l’un des outils suivants de [Image Viewer](/fr/fine-reader/engine/visual-components-reference/imageviewer) :

* Dessiner une zone de reconnaissance ([MI\_ChooseTool\_DrawRecognitionArea](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawrecognitionarea))
* Dessiner une zone de texte ([MI\_ChooseTool\_DrawTextBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawtextblock))
* Dessiner une zone de tableau ([MI\_ChooseTool\_DrawTableBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawtableblock))
* Dessiner une zone d’image ([MI\_ChooseTool\_DrawPictureBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawpictureblock))
* Dessiner une zone d’image d’arrière-plan ([MI\_ChooseTool\_DrawBackgroundPictureBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawbackgroundpictureblock))
* Dessiner une zone Barcode ([MI\_ChooseTool\_DrawBarcodeBlock](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawbarcodeblock))

Consultez la description des [Image Viewer Commands](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands) pour savoir comment sélectionner ces outils.

Elle transmet au client des informations sur le bloc tracé : son type et sa région. Cette méthode permet également d’annuler l’opération.

<div id="syntax">
  ## Syntaxe
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT OnToolAddBlock(
  BlockTypeEnum  Type,
  IFRRectangle*  BlockRect,
  VARIANT_BOOL** Cancel
);
```

### C\#

```csharp theme={null}
void OnToolAddBlock(
  BlockTypeEnum Type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub OnToolAddBlock( _
  Type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)
```

<div id="parameters">
  ## Paramètres
</div>

Type

\[in] Contient le type du bloc. Voir la description des constantes [BlockTypeEnum](/fr/fine-reader/engine/api-reference/enumerations/blocktypeenum).

BlockRect

\[in] Contient les coordonnées du bloc en pixels. Les coordonnées sont représentées par l'objet [FRRectangle](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle). Les coordonnées sont relatives à l'image du document.

Cancel

\[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le traitement doit être interrompu. Dans ce cas, le bloc ne sera pas créé.

<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 que, 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 n’est propagée à 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>

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