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

> Método OnToolChangeBlockRegion de la interfaz IImageViewerEvents en ABBYY FineReader Engine Visual Components para Windows: este método se implementa del lado del cliente.

Este método se implementa en el lado del cliente. ABBYY FineReader Engine lo llama antes de cambiar una región del bloque que se ha modificado 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" /> Agregar parte de un 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 de un 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 seleccionan estas herramientas.

Proporciona al cliente información sobre los bloques cuyas regiones se han modificado y sobre la nueva región del bloque resultante. El método se llama para cada bloque resultante. Por ejemplo, si dos regiones se han combinado en un solo bloque, el método se llama solo una vez. Si las regiones de dos bloques se han recortado con una herramienta, el método se llama dos veces. Si se ha eliminado un bloque con una herramienta, no se llama a este método. Este método permite 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,
  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">
  ## Parámetros
</div>

BlocksToChange

\[in] Contiene los índices de los bloques modificados en forma de objeto [IntsCollection](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection). La colección contiene más de un elemento solo si se han combinado varios bloques en uno solo.

NewRegion

\[in] Contiene la nueva región del bloque resultante en forma de 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 finalizar. En este caso, las regiones de los bloques no se modificarán.

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

\[Solo C++] Si este método devuelve un valor distinto de S\_OK, significa que se ha producido un error en el lado del cliente y, en ese 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 gestionen, y que no se propaguen fuera de él. 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>

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