Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine dal metodo InjectTextLayer dell’oggetto Engine. Fornisce al client suggerimenti e avvisi generati durante l’elaborazione. Può inoltre elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri bloccata durante operazioni lunghe.

Sintassi

C++

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

C#

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

Visual Basic .NET

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

Parametri

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 elaborazione che segnala il suggerimento restituisce E_ABORT.

Valori di ritorno

[Solo C++] Se questo method 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 considerato.

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 al di fuori del metodo. La propagazione di un’eccezione al di fuori del metodo può portare a risultati imprevedibili, come la terminazione del programma.

Vedi anche

IProcessingEvents IEngine::InjectTextLayer