OnToolAddBlock-Methode der IImageViewerEvents-Schnittstelle

OnToolAddBlock-Methode der IImageViewerEvents-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 aufgerufen, bevor ein neuer Block hinzugefügt wird, der mit einem der folgenden Werkzeuge im 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 übermittelt 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. Die Koordinaten sind im Objekt FRRectangle angegeben. Sie werden in Pixeln relativ zum Dokumentbild angegeben.

Cancel

[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang 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 clientseitig 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 in der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen außerhalb der Methode propagiert werden. Die Propagierung einer Ausnahme außerhalb der Methode kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).

​

Siehe auch

IImageViewerEvents