Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine prima di aggiungere un nuovo blocco disegnato con uno dei seguenti strumenti di Image Viewer: Vedere la descrizione dei comandi di Image Viewer per informazioni su come selezionare questi strumenti. Questo metodo fornisce al client informazioni sul blocco disegnato: il relativo tipo e la relativa regione. Tramite questo metodo è anche possibile 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. Vedere la descrizione delle costanti BlockTypeEnum. BlockRect [in] Contiene le coordinate del blocco. Le coordinate sono rappresentate dall’oggetto FRRectangle. Sono specificate in pixel rispetto all’immagine del documento. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. 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 sul lato client e, in tal caso, il valore del parametro Cancel viene ignorato.

​
Osservazioni

L’implementazione 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 al di fuori del metodo. La propagazione di un’eccezione al di fuori del metodo può causare risultati imprevedibili (ad esempio, l’arresto del programma).

​
Vedi anche

IImageViewerEvents