> ## 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 OnToolChangeBlockRegion de l’interface IImageViewerEvents

> Méthode OnToolChangeBlockRegion de l’interface IImageViewerEvents dans les composants visuels 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 la modification d’une région d’un bloc modifiée à l’aide de l’un des outils suivants de [Image Viewer](/fr/fine-reader/engine/visual-components-reference/imageviewer) :

* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_addpart.gif?s=adca0dfae4207e8af75ec13fa1315932" alt="tb_addPart" width="23" height="22" data-path="images/fine-reader/engine/tb_addpart.gif" /> Ajouter une partie de bloc ([MI\_ChooseTool\_AddBlockPart](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_addblockpart))
* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_delpart.gif?s=da5355ff634033aeff15f5b6429e59aa" alt="tb_delPart" width="23" height="22" data-path="images/fine-reader/engine/tb_delpart.gif" /> Couper une partie de bloc ([MI\_ChooseTool\_CutBlockPart](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_cutblockpart))

Consultez la description des [commandes d’Image Viewer](/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 les blocs dont les régions ont été modifiées, ainsi que sur la nouvelle région du bloc obtenu. La méthode est appelée pour chaque bloc obtenu. Par exemple, si deux régions ont été fusionnées en un seul bloc, la méthode n’est appelée qu’une seule fois. Si des régions appartenant à deux blocs ont été découpées à l’aide d’un outil, la méthode est appelée deux fois. Si un bloc a été supprimé à l’aide d’un outil, la méthode n’est pas appelée. Cette méthode permet d’annuler l’opération.

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

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

```cpp theme={null}
HRESULT OnToolChangeBlockRegion(
  IIntsCollection* BlocksToChange,
  IRegion*         NewRegion,
  VARIANT_BOOL*    Cancel
);
```

### C\#

```csharp theme={null}
void OnToolChangeBlockRegion(
  IIntsCollection     BlocksToChange,
  IRegion         NewRegion,
  out bool       Cancel
);
```

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

```vb theme={null}
Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)
```

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

BlocksToChange

\[in] Contient les indices des blocs modifiés sous la forme d’un objet [IntsCollection](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection). La collection ne contient plus d’un élément que si plusieurs blocs ont été fusionnés en un seul.

NewRegion

\[in] Contient la nouvelle région du bloc résultant sous la forme d’un 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, les régions des blocs ne seront pas modifiées.

<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 cliente de cette méthode doit veiller à ce que toutes les exceptions levées à l’intérieur de la méthode soient interceptées et traitées, et à ce qu’aucune exception ne soit propagée à l’extérieur de la méthode. La propagation d’une exception à l’extérieur 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)