Metodo OnCorrectPerspective dell'interfaccia IImageViewerEvents
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima della correzione delle distorsioni prospettiche nelle pagine immagine in Image Viewer. L’operazione viene avviata se si fa clic sul pulsante Correggi questa immagine nella sezione Correggi le distorsioni trapezoidali della finestra di dialogo Editor immagini.Il metodo passa al client l’indice della pagina che sta per essere modificata e le coordinate dei nuovi angoli della pagina. Tramite questo metodo è possibile annullare l’operazione.
Sub OnCorrectPerspective( _ PageIndex As Integer, _ TopLeft As IPoint, _ TopRight As IPoint, _ BottomRight As IPoint, _ BottomLeft As IPoint, _ ByRef Cancel As Boolean _)
PageIndex[in] Contiene l’indice della pagina per la quale verranno corrette le distorsioni trapezoidali.TopLeft[in] Contiene le coordinate del punto dell’immagine che diventerà il nuovo angolo superiore sinistro dell’immagine corretta. Vedere la descrizione dell’oggetto Point.TopRight[in] Contiene le coordinate del punto dell’immagine che diventerà il nuovo angolo superiore destro dell’immagine corretta. Vedere la descrizione dell’oggetto Point.BottomRight[in] Contiene le coordinate del punto dell’immagine che diventerà il nuovo angolo inferiore destro dell’immagine corretta. Vedere la descrizione dell’oggetto Point.BottomLeft[in] Contiene le coordinate del punto dell’immagine che diventerà il nuovo angolo inferiore sinistro dell’immagine corretta. Vedere la descrizione dell’oggetto Point.Cancel[out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, le distorsioni prospettiche non verranno corrette.
[Solo C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore sul lato client e, in questo caso, il valore del parametro Cancel non viene considerato.
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 all’esterno del metodo può portare a risultati imprevedibili (come la chiusura del programma).