OnEditImages-Methode der IImageViewerEvents-Schnittstelle
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor Beginn der Bildbearbeitung in Image Viewer aufgerufen. Der Vorgang wird ausgelöst, wenn einer der folgenden Befehle aufgerufen wird:
Die Befehle können über die entsprechenden Schaltflächen in der Symbolleiste (falls vorhanden), über Einträge im Kontextmenü, per Tastenkombinationen oder mit der Methode DoCommand von IImageViewer::Commands aufgerufen werden. Welche Aufrufmöglichkeit für welchen Befehl verfügbar ist, finden Sie in der Liste Image Viewer Commands.Die Methode liefert dem Client Informationen über die Indizes der Seiten, die bearbeitet werden sollen, sowie über den Befehl, der für die Bearbeitung verwendet wird. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.
PageIndices[in] Enthält die Indizes der Seiten, die bearbeitet werden sollen, als Objekt vom Typ IntsCollection.MenuItem[in] Gibt den Befehl an, der für die Bildbearbeitung verwendet wird. Siehe die Beschreibung der Konstanten in MenuItemEnum. Die folgenden Konstanten können als Wert für diesen Parameter verwendet werden: MI_DeskewImage, MI_StraightenTextLines, MI_ReduceISONoise, MI_RemoveMotionBlur, MI_RotateClockwise, MI_RotateCounterClockwise, MI_RotateUpsideDown, MI_FlipHorizontal, MI_FlipVertical, MI_InvertImage.Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang beendet werden soll. In diesem Fall wird das Bild nicht bearbeitet.
[Nur 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 außerhalb der Methode weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).