OnCorrectPerspective-Methode der IImageViewerEvents-Schnittstelle
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor perspektivische Verzerrungen auf Bildseiten im Image Viewer korrigiert werden. Der Vorgang wird ausgelöst, wenn im Abschnitt „Trapezverzerrungen korrigieren“ des Dialogfelds „Image Editor“ auf die Schaltfläche „Dieses Bild korrigieren“ geklickt wird.Die Methode übergibt dem Client den Index der Seite, die geändert werden soll, sowie die Koordinaten der neuen Seitenecken. Mithilfe dieser Methode kann der Vorgang auch abgebrochen werden.
Sub OnCorrectPerspective( _ PageIndex As Integer, _ TopLeft As IPoint, _ TopRight As IPoint, _ BottomRight As IPoint, _ BottomLeft As IPoint, _ ByRef Cancel As Boolean _)
PageIndex[in] Enthält den Index der Seite, für die die Trapezverzerrungen korrigiert werden sollen.TopLeft[in] Enthält die Koordinaten des Punkts im Bild, der die neue linke obere Ecke des korrigierten Bildes bildet. Siehe die Beschreibung des Point-Objekts.TopRight[in] Enthält die Koordinaten des Punkts im Bild, der die neue rechte obere Ecke des korrigierten Bildes bildet. Siehe die Beschreibung des Point-Objekts.BottomRight[in] Enthält die Koordinaten des Punkts im Bild, der die neue rechte untere Ecke des korrigierten Bildes bildet. Siehe die Beschreibung des Point-Objekts.BottomLeft[in] Enthält die Koordinaten des Punkts im Bild, der die neue linke untere Ecke des korrigierten Bildes bildet. Siehe die Beschreibung des Point-Objekts.Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall werden perspektivische Verzerrungen nicht korrigiert.
[Nur in C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, weist dies darauf hin, dass clientseitig ein Fehler aufgetreten ist. In diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.
Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen die Methode verlassen. Wenn eine Ausnahme die Methode verlässt, kann dies zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).