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 venant d’être dessiné à 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. Cette méthode transmet au client des informations sur le bloc qui a été dessiné : son type et sa région. Elle 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. Les coordonnées sont représentées par l’objet FRRectangle. Les coordonnées sont indiquées en pixels par rapport à 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, 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 exception n’est propagée à l’extérieur de la méthode. La propagation d’une exception hors de la méthode peut entraîner des résultats imprévisibles (comme l’arrêt du programme).

​
Voir aussi

IImageViewerEvents