OnWarning-Methode der IFRPageEvents-Schnittstelle

OnWarning-Methode der IFRPageEvents-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Methode, die aufgerufen wird, um während der FRPage-Verarbeitung aufgetretene Hinweise und Warnungen zu übermitteln.

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.

​

Syntax

​

C++

HRESULT OnWarning(
  IFRPage*      Sender,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

​

C#

void OnWarning(
  IFRPage   Sender,
  string   Warning,
  ref bool Cancel
);

​

Visual Basic .NET

Sub OnWarning( _
  Sender As IFRPage, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

​

Parameter

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.

​

Rückgabewerte

[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.

​

Bemerkungen

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).

​

Siehe auch

IFRPageEvents

FRPage