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

# Methode OnToolChangeBlockRegion der Schnittstelle IZoomViewerEvents

> Methode OnToolChangeBlockRegion der Schnittstelle IZoomViewerEvents 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, der zuvor im [Zoom Viewer](/de/fine-reader/engine/visual-components-reference/zoomviewer) mithilfe eines 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 Commands](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands) erfahren Sie, wie diese Werkzeuge ausgewählt werden können.

Sie übermittelt dem Client Informationen zu den Blöcken, deren Regionen geändert wurden, sowie zur neuen Region des resultierenden Blocks. Mithilfe 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,
  Region          NewRegion,
  out bool        Cancel
);
```

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

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

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

blocksToChange

\[in] Enthält die Indizes der geänderten Blöcke als [IntsCollection](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection)-Objekt.

NewRegion

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

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, bedeutet dies, 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. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).

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

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