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

> Méthode OnToolChangeTable de l’interface IImageViewerEvents 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 de modifier un bloc de tableau à l’aide d’un outil de [Image Viewer](/fr/fine-reader/engine/visual-components-reference/imageviewer) :

* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_vertline.gif?s=0310d84f26192721ab13164545559986" alt="tb_VertLine" width="23" height="22" data-path="images/fine-reader/engine/tb_vertline.gif" /> Ajouter un Separator vertical ([MI\_ChooseTool\_AddVertSeparator](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_addvertseparator))
* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_horizontline.gif?s=49d36c57e5067d16666945864c31f102" alt="tb_horizontLine" width="23" height="22" data-path="images/fine-reader/engine/tb_horizontline.gif" /> Ajouter un Separator horizontal ([MI\_ChooseTool\_AddHorizSeparator](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_addhorizseparator))
* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_delline.gif?s=f1548dc0be446f4e53efd531e4bc6e15" alt="tb_delLine" width="23" height="22" data-path="images/fine-reader/engine/tb_delline.gif" /> Supprimer le Separator ([MI\_ChooseTool\_DeleteSeparator](/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_deleteseparator))

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 l’indice du bloc de tableau qui va être modifié, ainsi que la position et le type du Separator ajouté ou supprimé. Cette méthode permet d’annuler l’opération.

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

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

```cpp theme={null}
HRESULT OnToolChangeTable(
  int           BlockIndex,
  int           Position,
  VARIANT_BOOL  IsVerticalSeparator,
  VARIANT_BOOL  DeleteSeparator,
  VARIANT_BOOL* Cancel
);
```

### C\#

```csharp theme={null}
void OnToolChangeTable(
  int      BlockIndex,
  int      Position,
  bool     IsVerticalSeparator,
  bool     deleteSeparator,
  out bool Cancel
);
```

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

```vb theme={null}
Sub OnToolChangeTable( _
  BlockIndex As Integer, _
  Position As Integer, _
  IsVerticalSeparator As Boolean, _
  DeleteSeparator As Integer, _
  ByRef Cancel As Boolean _
)
```

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

BlockIndex

\[in] Contient l’indice du bloc de tableau à modifier. L’indice se trouve dans la collection [ILayout::VisualBlocks](/fr/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks).

Position

\[in] Contient la position du Separator dans le tableau. La position du Separator correspond à sa coordonnée dans une grille de base.

IsVerticalSeparator

\[in] Indique si le Separator est vertical ou horizontal.

DeleteSeparator

\[in] Indique si le Separator doit être supprimé ou ajouté.

Cancel

\[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, le Separator ne sera pas ajouté (ou supprimé).

<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 ; dans ce cas, la valeur du paramètre Cancel n'est pas prise en compte.

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

* Par grille de base, nous entendons ici la grille formée par les bordures et les séparateurs du tableau. Chaque séparateur vertical incrémente la coordonnée horizontale d'une unité, et chaque séparateur horizontal incrémente la coordonnée verticale d'une unité. Les axes de coordonnées sont orientés de gauche à droite et de haut en bas.
* L'implémentation côté client de cette méthode doit garantir que toutes les exceptions levées à l'intérieur de la méthode sont interceptées et gérées, et qu'aucune exception n'est propagée 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 (tels que l'arrêt du programme).

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

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