OnAnalyzePage-Methode der IZoomViewerEvents-Schnittstelle
Diese Methode wird auf der Client-Seite implementiert. Sie wird von ABBYY FineReader Engine vor dem Start des Seitenanalyseprozesses aufgerufen, der im Zoom Viewer auf eine der folgenden Arten ausgelöst wurde:
Der Eintrag „Seitenlayout analysieren“ im Kontextmenü wird ausgewählt
Die Tastenkombination Ctrl+E wird gedrückt
Der Befehl MI_AnalyzeLayout wird mithilfe der Methode DoCommand von IZoomViewer::Commands aufgerufen
Sie informiert den Client darüber, dass eine aktive Seite analysiert wird. Mithilfe 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 die Seite nicht analysiert.
[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 Clientimplementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen über die Methode hinaus weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).