Saltar al contenido principal
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: Consulte la descripción de 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.

​
Sintaxis

​
C++

HRESULT OnToolChangeBlockRegion(
  IIntsCollection* BlocksToChange,
  IRegion*         NewRegion,
  VARIANT_BOOL*    Cancel
);

​
C#

void OnToolChangeBlockRegion(
  IIntsCollection     BlocksToChange,
  IRegion         NewRegion,
  out bool       Cancel
);

​
Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)

​
Parámetros

BlocksToChange [in] Contiene los índices de los bloques modificados en forma de objeto 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. 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.

​
Valores de retorno

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

​
Observaciones

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

​
Consulte también

IImageViewerEvents