Método OnToolChangeBlockRegion de la interfaz IZoomViewerEvents

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 con una de las siguientes herramientas de Image Viewer:

• Añadir parte del bloque (MI_ChooseTool_AddBlockPart)
• Cortar parte del bloque (MI_ChooseTool_CutBlockPart)

Consulte la descripción de 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.

​

Sintaxis

​

C++

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

​

C#

void OnToolChangeBlockRegion(
  IIntsCollection  blocksToChange,
  Region          NewRegion,
  out bool        Cancel
);

​

Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  blocksToChange As IIntsCollection, _
  NewRegion As Region, _
  ByRef Cancel As Boolean _
)

​

Parámetros

blocksToChange

[in] Contiene los índices de los bloques modificados como un objeto IntsCollection.

NewRegion

[in] Contiene la nueva región del bloque resultante como un objeto 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.

​

Valores de retorno

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

​

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

​

Consulte también

IZoomViewerEvents