Methode OnCropImages der Schnittstelle IImageViewerEvents
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor Bilder im Image Viewer zugeschnitten werden. Der Vorgang wird ausgelöst, wenn im Abschnitt Crop des Dialogfelds Image Editor auf die Schaltfläche Crop Image geklickt wird.Die Methode übergibt dem Client die Indizes der Seiten, die zugeschnitten werden sollen, sowie die Koordinaten des Beschneidungsrechtecks. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.
PageIndices[in] Enthält die Indizes der Seiten, die zugeschnitten werden sollen, als IntsCollection-Objekt.Rect[in] Enthält das Beschneidungsrechteck als FRRectangle-Objekt. Die Koordinaten werden in Pixeln relativ zum Dokumentbild angegeben.Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall werden die Seiten nicht zugeschnitten.
[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, weist dies auf einen clientseitigen Fehler hin; in diesem Fall wird der Wert des Cancel-Parameters 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 aus der Methode nach außen weitergegeben werden. Die Weitergabe einer Ausnahme aus der Methode nach außen kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).