Méthode OnToolAddBlock de l'interface IImageViewerEvents

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 :

• Dessiner une zone de reconnaissance (MI_ChooseTool_DrawRecognitionArea)
• Dessiner une zone de texte (MI_ChooseTool_DrawTextBlock)
• Dessiner une zone de tableau (MI_ChooseTool_DrawTableBlock)
• Dessiner une zone d’image (MI_ChooseTool_DrawPictureBlock)
• Dessiner une zone d’image d’arrière-plan (MI_ChooseTool_DrawBackgroundPictureBlock)
• Dessiner une zone de Barcode (MI_ChooseTool_DrawBarcodeBlock)

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