Metodo OnEditImages dell'interfaccia IImageViewerEvents
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima dell’inizio della modifica delle immagini in Image Viewer. Il processo viene avviato se viene chiamato uno dei seguenti comandi:
I comandi possono essere chiamati tramite i pulsanti corrispondenti sulla barra degli strumenti (se presenti), le voci del menu contestuale, i tasti di scelta rapida oppure usando il metodo DoCommand di IImageViewer::Commands. Per verificare quale modalità è disponibile per ciascun comando, consultare l’elenco Image Viewer Commands.Il metodo fornisce al client informazioni sugli indici delle pagine che stanno per essere modificate e sul comando che verrà usato per la modifica. Questo metodo consente di annullare l’operazione.
PageIndices[in] Contiene gli indici delle pagine che verranno modificate sotto forma di oggetto IntsCollection.MenuItem[in] Specifica il comando utilizzato per modificare l’immagine. Vedere la descrizione delle costanti MenuItemEnum. Questo parametro può assumere uno dei seguenti valori: MI_DeskewImage, MI_StraightenTextLines, MI_ReduceISONoise, MI_RemoveMotionBlur, MI_RotateClockwise, MI_RotateCounterClockwise, MI_RotateUpsideDown, MI_FlipHorizontal, MI_FlipVertical, MI_InvertImage.Cancel[out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, l’immagine non verrà modificata.
[Solo in 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.
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 si propaghi all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili (come la terminazione del programma).