Méthode OnToolChangeTable de l’interface IImageViewerEvents

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 :

• Ajouter un Separator vertical (MI_ChooseTool_AddVertSeparator)
• Ajouter un Separator horizontal (MI_ChooseTool_AddHorizSeparator)
• Supprimer le Separator (MI_ChooseTool_DeleteSeparator)

Consultez la description des commandes d’Image Viewer 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.

​

Syntaxe

​

C++

HRESULT OnToolChangeTable(
  int           BlockIndex,
  int           Position,
  VARIANT_BOOL  IsVerticalSeparator,
  VARIANT_BOOL  DeleteSeparator,
  VARIANT_BOOL* Cancel
);

​

C#

void OnToolChangeTable(
  int      BlockIndex,
  int      Position,
  bool     IsVerticalSeparator,
  bool     deleteSeparator,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnToolChangeTable( _
  BlockIndex As Integer, _
  Position As Integer, _
  IsVerticalSeparator As Boolean, _
  DeleteSeparator As Integer, _
  ByRef Cancel As Boolean _
)

​

Paramètres

BlockIndex

[in] Contient l’indice du bloc de tableau à modifier. L’indice se trouve dans la collection ILayout::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é).

​

Valeurs de retour

[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.

​

Remarques

• 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).

​

Voir aussi

IImageViewerEvents