Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant de modifier une région d’un bloc modifié dans le Zoom Viewer à l’aide de l’un des outils suivants de l’Image Viewer : Voir la description des 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. À l’aide de cette méthode, il est possible d’annuler l’opération.

​
Syntaxe

​
C++

HRESULT OnToolChangeBlockRegion(
  IIntsCollection*  blocksToChange,
  IRegion*          NewRegion,
  VARIANT_BOOL*     Cancel
);

​
C#

void OnToolChangeBlockRegion(
  IIntsCollection  blocksToChange,
  Region          NewRegion,
  out bool        Cancel
);

​
Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  blocksToChange As IIntsCollection, _
  NewRegion As Region, _
  ByRef Cancel As Boolean _
)

​
Paramètres

blocksToChange [in] Contient les indices des blocs modifiés, sous la forme de l’objet IntsCollection. NewRegion [in] Contient la nouvelle région du bloc résultant, sous la forme de l’objet 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.

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

​
Remarques

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 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 (comme l’arrêt du programme).

​
Voir aussi

IZoomViewerEvents