OnReadPages-Methode der IDocumentViewerEvents-Schnittstelle
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor Beginn des Seitenerkennungsprozesses aufgerufen, der im Document Viewer auf eine der folgenden Arten gestartet wurde:
Der Menübefehl Read Page im Kontextmenü wird ausgewählt
die Tastenkombination Ctrl+R wird gedrückt
der Befehl MI_Read wird mit der Methode DoCommand von IDocumentViewer::Commands aufgerufen
Sie informiert den Client darüber, dass die ausgewählten Seiten erkannt werden. Mit dieser Methode kann der Vorgang abgebrochen werden.
Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess abgebrochen werden soll. In diesem Fall wird keine Erkennung durchgeführt.
[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 über die Methode hinaus propagiert werden. Die Propagierung einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).