Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine per alcuni metodi dell’oggetto FRDocument. Fornisce al client suggerimenti e avvisi verificatisi durante l’elaborazione.
In Windows, può anche gestire eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni lunghe. Questo può risultare utile nelle applicazioni con interfaccia utente.

​
Sintassi

​
C++

HRESULT OnWarning(
  IFRDocument*  Sender,
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

​
C#

void OnWarning(
  IFRDocument Sender,
  int        PageIndex,
  string     Warning,
  ref bool   Cancel
);

​
Visual Basic .NET

Sub OnWarning( _
  Sender As IFRDocument,  _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

​
Parametri

Sender [in] Fa riferimento all’oggetto FRDocument che invia le notifiche. PageIndex [in] Questo parametro contiene l’indice della pagina a cui si riferisce il suggerimento o l’avviso. Il messaggio può riferirsi non solo a una singola pagina, ma all’intero documento. In questo caso, il valore del parametro è -1. Warning [in] Contiene il suggerimento o l’avviso. Cancel [in, out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, la funzione di analisi o riconoscimento che segnala il suggerimento o l’avviso restituisce E_ABORT.

​
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 questo caso, il valore del parametro Cancel non viene preso in considerazione.

​
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 all’esterno del metodo. La propagazione di un’eccezione al di fuori del metodo può causare risultati imprevedibili (ad esempio, la terminazione del programma).

​
Vedere anche

IFRDocumentEvents FRDocument