Zum Hauptinhalt springen
Diese Methode ist clientseitig implementiert. Sie wird von ABBYY FineReader Engine für einige der Methoden des FRPage-Objekts aufgerufen. Sie übermittelt dem Client Informationen über die verarbeitete Region.
Unter Windows kann sie außerdem Systemmeldungen verarbeiten, damit die Anwendung während langwieriger Vorgänge weiterhin reagiert. Dies kann in Anwendungen mit einer Benutzeroberfläche hilfreich sein.

Syntax

C++

HRESULT OnRegionProcessed(
  IFRPage*      Sender,
  int           RecognitionPassNumber,
  IRegion*      Region,
  VARIANT_BOOL* Cancel
);

C#

void OnRegionProcessed(
  IFRPage   Sender,
  int      RecognitionPassNumber,
  IRegion   Region,
  ref bool Cancel
);

Visual Basic .NET

Sub OnRegionProcessed( _
  Sender As IFRPage, _
  RecognitionPassNumber As Integer, _
  Region As IRegion, _
  ByRef Cancel As Boolean _
)

Parameter

Sender [in] Dieser Parameter verweist auf das FRPage-Objekt, das Benachrichtigungen sendet. RecognitionPassNumber [in] Dieser Parameter gibt die Nummer des Erkennungsdurchlaufs an. Sie kann 0, 1 oder 2 sein. Rechtecke aus verschiedenen Durchläufen können mit unterschiedlichen Farben gefüllt werden, wie in ABBYY FineReader. Region [in] Dieser Parameter verweist auf das Region-Objekt, das der gerade verarbeiteten Region entspricht. Cancel [in, out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess abgebrochen werden soll. In diesem Fall gibt die Verarbeitungsfunktion E_ABORT zurück.

Rückgabewerte

[Nur für 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 Cancel-Parameters nicht berü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 propagiert werden. Die Propagierung einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).

Siehe auch

IFRPageEvents FRPage