Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine bei einigen Methoden des FRPage-Objekts aufgerufen. Sie übermittelt dem Client Hinweise und Warnungen, die während der Verarbeitung aufgetreten sind.
Unter Windows kann sie außerdem beliebige Systemmeldungen verarbeiten, damit die Anwendung bei langen Vorgängen nicht den Eindruck macht, nicht mehr zu reagieren. Das kann bei Anwendungen mit einer Benutzeroberfläche hilfreich sein.
HRESULT OnWarning(
IFRPage* Sender,
BSTR Warning,
VARIANT_BOOL* Cancel
);
void OnWarning(
IFRPage Sender,
string Warning,
ref bool Cancel
);
Sub OnWarning( _
Sender As IFRPage, _
Warning As String, _
ByRef Cancel As Boolean _
)
Sender
[in] Verweist auf das Objekt FRPage, das Benachrichtigungen sendet.
Warning
[in] Enthält einen Hinweis oder eine Warnung.
Cancel
[in, out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall gibt die Verarbeitungsfunktion, die den Hinweis meldet, E_ABORT zurück.
[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet das, 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 weitergegeben werden. Wird eine Ausnahme über die Methode hinaus weitergegeben, kann dies zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).
IFRPageEvents
FRPage