Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine per alcuni dei metodi dell’oggetto FRPage. Fornisce al client suggerimenti e avvisi generati durante l’elaborazione.
In Windows, può inoltre elaborare qualsiasi messaggio di sistema per evitare che l’applicazione risulti non reattiva durante operazioni prolungate. Ciò può essere utile nelle applicazioni dotate di interfaccia utente.

​
Sintassi

​
C++

HRESULT OnWarning(
  IFRPage*      Sender,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

​
C#

void OnWarning(
  IFRPage   Sender,
  string   Warning,
  ref bool Cancel
);

​
Visual Basic .NET

Sub OnWarning( _
  Sender As IFRPage, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

​
Parametri

Sender [in] Fa riferimento all’oggetto FRPage che invia le notifiche. Warning [in] Contiene il suggerimento o l’avviso. Cancel [in, out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato. In tal caso, la funzione di elaborazione che riporta il suggerimento 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; in tal 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 al suo interno 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ò portare a risultati imprevedibili (ad esempio, la terminazione del programma).

​
Vedere anche

IFRPageEvents FRPage