OnSplitImages-Methode der IImageViewerEvents-Schnittstelle
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor dem Teilen von Bildern in Image Viewer aufgerufen. Der Vorgang wird ausgelöst, wenn im Abschnitt Split des Dialogfelds Image Editor auf die Schaltfläche Split by Line oder Split Automatically geklickt wird.Die Methode übermittelt dem Client Informationen zu den konkreten Bildern, die geteilt werden sollen, sowie zu den Regionen, die für das Teilen verwendet werden. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.
PageIndices[in] Enthält die Indizes der Seiten, die mithilfe des Objekts IntsCollection aufgeteilt werden sollen.Regions[in] Enthält die Sammlung von Regionen, die mithilfe des Objekts RegionsCollection zum Aufteilen von Bildern verwendet werden.Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall gibt die entsprechende Funktion E_ABORT zurück.
[Nur in C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, 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 aus der Methode nach außen weitergegeben werden. Wird eine Ausnahme aus der Methode nach außen weitergegeben, kann dies zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).