Passer au contenu principal
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 à l’aide de l’un des outils suivants de Image Viewer : Consultez la description des 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.

​
Syntaxe

​
C++

HRESULT OnToolAddBlock(
  BlockTypeEnum  Type,
  IFRRectangle*  BlockRect,
  VARIANT_BOOL** Cancel
);

​
C#

void OnToolAddBlock(
  BlockTypeEnum Type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);

​
Visual Basic .NET

Sub OnToolAddBlock( _
  Type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)

​
Paramètres

Type [in] Contient le type du bloc. Voir la description des constantes BlockTypeEnum. BlockRect [in] Contient les coordonnées du bloc en pixels. Les coordonnées sont représentées par l’objet 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éé.

​
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 que, 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 à 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).

​
Voir aussi

IZoomViewerEvents