OnReadBlocks-Methode der IZoomViewerEvents-Schnittstelle

OnReadBlocks-Methode der IZoomViewerEvents-Schnittstelle in ABBYY FineReader Engine Visual Components unter Windows — Diese Methode wird clientseitig implementiert.

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine vor Beginn der Blockerkennung aufgerufen, die im Zoom Viewer auf eine der folgenden Arten ausgelöst wurde:

• Der Eintrag „Read Area“ im Kontextmenü wird ausgewählt
• Die Tastenkombination Strg+Umschalt+B wird gedrückt
• Der Befehl MI_ReadBlock wird mit der Methode DoCommand von IZoomViewer::Commands aufgerufen

Die Methode übermittelt dem Client die Indizes der Blöcke, die erkannt werden sollen. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​

Syntax

​

C++

HRESULT OnReadBlocks(
  IIntsCollection*  BlocksIndices,
  VARIANT_BOOL*     Cancel
);

​

C#

void OnReadBlocks(
  IIntsCollection BlocksIndices,
  out bool       Cancel
);

​

Visual Basic .NET

Sub OnReadBlocks( _
  BlocksIndices As IIntsCollection, _
  ByRef Cancel As Boolean _
)

​

Parameter

BlocksIndices

[in] Enthält die Indizes der Blöcke, die als IntsCollection-Objekt erkannt werden sollen.

Cancel

[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall wird keine Erkennung durchgeführt.

​

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

​

Siehe auch

IZoomViewerEvents

OnReadPage