OnToolAddBlock-Methode der IZoomViewerEvents-Schnittstelle

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

Diese Methode wird auf der Clientseite implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor ein neuer Block hinzugefügt wird, der im Zoom Viewer mit einem der folgenden Werkzeuge des Image Viewer gezeichnet wurde:

• Erkennungsbereich zeichnen (MI_ChooseTool_DrawRecognitionArea)
• Textbereich zeichnen (MI_ChooseTool_DrawTextBlock)
• Tabellenbereich zeichnen (MI_ChooseTool_DrawTableBlock)
• Bildbereich zeichnen (MI_ChooseTool_DrawPictureBlock)
• Hintergrundbildbereich zeichnen (MI_ChooseTool_DrawBackgroundPictureBlock)
• Barcode-Bereich zeichnen (MI_ChooseTool_DrawBarcodeBlock)

In der Beschreibung der Image Viewer Commands erfahren Sie, wie diese Werkzeuge ausgewählt werden können.

Sie übergibt dem Client Informationen über den gezeichneten Block: seinen Typ und seine Region. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​

Syntax

​

C++

HRESULT OnToolAddBlock(
  BlockTypeEnum  Type,
  IFRRectangle*  BlockRect,
  VARIANT_BOOL** Cancel
);

​

C#

void OnToolAddBlock(
  BlockTypeEnum Type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);

​

Visual Basic .NET

Sub OnToolAddBlock( _
  Type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)

​

Parameter

Type

[in] Enthält den Typ des Blocks. Siehe die Beschreibung der Konstanten BlockTypeEnum.

BlockRect

[in] Enthält die Koordinaten des Blocks in Pixeln. Die Koordinaten sind im Objekt FRRectangle angegeben. Die Koordinaten beziehen sich auf das Bild des Dokuments.

Cancel

[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess abgebrochen werden soll. In diesem Fall wird der Block nicht erstellt.

​

Rückgabewerte

[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, weist dies darauf hin, dass auf der Clientseite ein Fehler aufgetreten ist. In diesem Fall wird der Wert des Parameters Cancel 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 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