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

# Método OnToolChangeBlockRegion de la interfaz IZoomViewerEvents

> Método OnToolChangeBlockRegion de la interfaz IZoomViewerEvents en ABBYY FineReader Engine Visual Components en Windows — Este método se implementa del lado del cliente.

Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama antes de cambiar una región del bloque que se ha modificado en [Zoom Viewer](/es/fine-reader/engine/visual-components-reference/zoomviewer) con una de las siguientes herramientas de [Image Viewer](/es/fine-reader/engine/visual-components-reference/imageviewer):

* <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" /> Añadir parte del bloque ([MI\_ChooseTool\_AddBlockPart](/es/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" /> Cortar parte del bloque ([MI\_ChooseTool\_CutBlockPart](/es/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_choosetool_cutblockpart))

Consulte la descripción de [Image Viewer Commands](/es/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands) para saber cómo se pueden seleccionar estas herramientas.

Proporciona al cliente información sobre los bloques cuyas regiones han cambiado y sobre la nueva región del bloque resultante. Con este método, es posible cancelar la operación.

<div id="syntax">
  ## Sintaxis
</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">
  ## Parámetros
</div>

blocksToChange

\[in] Contiene los índices de los bloques modificados como un objeto [IntsCollection](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection).

NewRegion

\[in] Contiene la nueva región del bloque resultante como un objeto [Region](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/region).

Cancel

\[out] Puede establecer esta variable en TRUE para indicar que el proceso debe interrumpirse. En este caso, no se cambiarán las regiones de los bloques.

<div id="return-values">
  ## Valores de retorno
</div>

\[Solo C++] Si este método devuelve un valor distinto de S\_OK, indica que se produjo un error del lado del cliente y, en este caso, no se tiene en cuenta el valor del parámetro Cancel.

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

La implementación cliente de este método debe garantizar que todas las excepciones que se produzcan dentro del método se capturen y se gestionen, y que ninguna excepción se propague fuera del método. La propagación de una excepción fuera del método puede dar lugar a resultados impredecibles (como la finalización del programa).

<div id="see-also">
  ## Consulte también
</div>

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