Zum Hauptinhalt springen
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine bei einigen Methoden des FRDocument-Objekts aufgerufen. Sie übermittelt dem Client Hinweise und Warnungen, die während der Verarbeitung auftreten.
Unter Windows kann sie außerdem Systemmeldungen verarbeiten, damit die Anwendung bei langen Vorgängen nicht den Eindruck erweckt, nicht mehr zu reagieren. Dies kann bei Anwendungen mit Benutzeroberfläche hilfreich sein.

​
Syntax

​
C++

HRESULT OnWarning(
  IFRDocument*  Sender,
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

​
C#

void OnWarning(
  IFRDocument Sender,
  int        PageIndex,
  string     Warning,
  ref bool   Cancel
);

​
Visual Basic .NET

Sub OnWarning( _
  Sender As IFRDocument,  _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

​
Parameter

Sender [in] Verweist auf das Objekt FRDocument, das Benachrichtigungen sendet. PageIndex [in] Dieser Parameter enthält den Index der Seite, auf die sich der Hinweis oder die Warnung bezieht. Die Meldung kann sich nicht nur auf eine einzelne Seite, sondern auf das gesamte Dokument beziehen. In diesem Fall ist der Wert des Parameters -1. Warning [in] Enthält den Hinweis oder die 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 Analyse- oder Erkennungsfunktion, die den Hinweis meldet, E_ABORT zurück.

​
Rückgabewerte

[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, dass clientseitig ein Fehler aufgetreten ist; in diesem Fall bleibt der Wert des Parameters Cancel unberücksichtigt.

​
Hinweise

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. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zu einem Programmabbruch).

​
Siehe auch

IFRDocumentEvents FRDocument