Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima di aggiungere un nuovo blocco disegnato in Zoom Viewer utilizzando uno dei seguenti strumenti di Image Viewer: Per informazioni su come selezionare questi strumenti, vedere la descrizione di Image Viewer Commands. Fornisce al client informazioni sul blocco disegnato: il relativo tipo e la relativa regione. Questo metodo consente anche di annullare l’operazione.

​
Sintassi

​
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 _
)

​
Parametri

Type [in] Contiene il tipo del blocco. Consultare la descrizione delle costanti BlockTypeEnum. BlockRect [in] Contiene le coordinate del blocco in pixel. Le coordinate sono rappresentate dall’oggetto FRRectangle. Le coordinate sono relative all’immagine del documento. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato. In questo caso, il blocco non verrà creato.

​
Valori di ritorno

[Solo C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore lato client e, in tal caso, il valore del parametro Cancel non viene preso in considerazione.

​
Osservazioni

L’implementazione del client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione venga propagata all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può portare a risultati imprevedibili, come la terminazione del programma.

​
Vedi anche

IZoomViewerEvents