> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/de/fine-reader/engine/visual-components-reference/zoomviewer) mit einem der folgenden Werkzeuge des [Image Viewer](/de/fine-reader/engine/visual-components-reference/imageviewer) gezeichnet wurde:

* Erkennungsbereich zeichnen ([MI\_ChooseTool\_DrawRecognitionArea](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawrecognitionarea))
* Textbereich zeichnen ([MI\_ChooseTool\_DrawTextBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawtextblock))
* Tabellenbereich zeichnen ([MI\_ChooseTool\_DrawTableBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawtableblock))
* Bildbereich zeichnen ([MI\_ChooseTool\_DrawPictureBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawpictureblock))
* Hintergrundbildbereich zeichnen ([MI\_ChooseTool\_DrawBackgroundPictureBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawbackgroundpictureblock))
* Barcode-Bereich zeichnen ([MI\_ChooseTool\_DrawBarcodeBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_drawbarcodeblock))

In der Beschreibung der [Image Viewer Commands](/de/fine-reader/engine/visual-components-reference/imageviewer/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.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT OnToolAddBlock(
  BlockTypeEnum  Type,
  IFRRectangle*  BlockRect,
  VARIANT_BOOL** Cancel
);
```

### C\#

```csharp theme={null}
void OnToolAddBlock(
  BlockTypeEnum Type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub OnToolAddBlock( _
  Type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)
```

<div id="parameters">
  ## Parameter
</div>

Type

\[in] Enthält den Typ des Blocks. Siehe die Beschreibung der Konstanten [BlockTypeEnum](/de/fine-reader/engine/api-reference/enumerations/blocktypeenum).

BlockRect

\[in] Enthält die Koordinaten des Blocks in Pixeln. Die Koordinaten sind im Objekt [FRRectangle](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/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.

<div id="return-values">
  ## Rückgabewerte
</div>

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

<div id="remarks">
  ## Hinweise
</div>

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

<div id="see-also">
  ## Siehe auch
</div>

[IZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents)