Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine per alcuni metodi dell’oggetto FRPage. Fornisce al client informazioni sulla regione in corso di elaborazione.
In Windows, può anche gestire eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni lunghe. Questo può essere utile nelle applicazioni con un’interfaccia utente.
HRESULT OnRegionProcessed(
IFRPage* Sender,
int RecognitionPassNumber,
IRegion* Region,
VARIANT_BOOL* Cancel
);
void OnRegionProcessed(
IFRPage Sender,
int RecognitionPassNumber,
IRegion Region,
ref bool Cancel
);
Sub OnRegionProcessed( _
Sender As IFRPage, _
RecognitionPassNumber As Integer, _
Region As IRegion, _
ByRef Cancel As Boolean _
)
Sender
[in] Questo parametro fa riferimento all’oggetto FRPage che invia le notifiche.
RecognitionPassNumber
[in] Questo parametro indica il numero del passaggio di riconoscimento. Può essere 0, 1 o 2. I Rectangle di passaggi diversi possono essere riempiti con colori differenti, come avviene in ABBYY FineReader.
Region
[in] Questo parametro fa riferimento all’oggetto Region corrispondente alla regione in elaborazione.
Cancel
[in, out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In tal caso, la funzione di elaborazione restituisce E_ABORT.
[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.
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).
IFRPageEvents
FRPage