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

# OnToolChangeBlockRegion-Methode der IImageViewerEvents-Schnittstelle

> OnToolChangeBlockRegion-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 die Region eines Blocks geändert wird, die mit einem der folgenden Werkzeuge des [Image Viewer](/de/fine-reader/engine/visual-components-reference/imageviewer) bearbeitet wurde:

* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_addpart.gif?s=adca0dfae4207e8af75ec13fa1315932" alt="tb_addPart" width="23" height="22" data-path="images/fine-reader/engine/tb_addpart.gif" /> Blockteil hinzufügen ([MI\_ChooseTool\_AddBlockPart](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_addblockpart))
* <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/tb_delpart.gif?s=da5355ff634033aeff15f5b6429e59aa" alt="tb_delPart" width="23" height="22" data-path="images/fine-reader/engine/tb_delpart.gif" /> Blockteil ausschneiden ([MI\_ChooseTool\_CutBlockPart](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_cutblockpart))

In der Beschreibung der [Image-Viewer-Befehle](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands) erfahren Sie, wie diese Werkzeuge ausgewählt werden können.

Sie liefert dem Client Informationen zu den Blöcken, deren Regionen geändert wurden, sowie zur neuen Region des resultierenden Blocks. Die Methode wird für jeden resultierenden Block aufgerufen. Wenn beispielsweise zwei Regionen zu einem Block zusammengeführt wurden, wird die Methode nur einmal aufgerufen. Wenn Regionen von zwei Blöcken mit einem Werkzeug ausgeschnitten wurden, wird die Methode zweimal aufgerufen. Wenn ein Block mit einem Werkzeug gelöscht wurde, wird die Methode nicht aufgerufen. Mit dieser Methode kann der Vorgang abgebrochen werden.

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

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

```cpp theme={null}
HRESULT OnToolChangeBlockRegion(
  IIntsCollection* BlocksToChange,
  IRegion*         NewRegion,
  VARIANT_BOOL*    Cancel
);
```

### C\#

```csharp theme={null}
void OnToolChangeBlockRegion(
  IIntsCollection     BlocksToChange,
  IRegion         NewRegion,
  out bool       Cancel
);
```

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

```vb theme={null}
Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)
```

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

BlocksToChange

\[in] Enthält die Indizes der geänderten Blöcke im Objekt [IntsCollection](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection). Die Sammlung enthält nur dann mehr als ein Element, wenn mehrere Blöcke zu einem Block zusammengeführt wurden.

NewRegion

\[in] Enthält die neue Region des resultierenden Blocks im Objekt [Region](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region).

Cancel

\[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall werden die Regionen der Blöcke nicht geändert.

<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 clientseitig 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. Wird eine Ausnahme über die Methode hinaus weitergegeben, kann dies zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).

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

[IImageViewerEvents](/de/fine-reader/engine/visual-components-reference/iimageviewerevents)