Saltar al contenido principal
Este método se implementa en el cliente. ABBYY FineReader Engine lo llama antes de añadir un nuevo bloque dibujado en Zoom Viewer mediante una de las siguientes herramientas de Image Viewer: Consulte la descripción de Image Viewer Commands para saber cómo seleccionar estas herramientas. Proporciona al cliente información sobre el bloque dibujado: su tipo y su región. Con este método también es posible cancelar la operación.

​
Sintaxis

​
C++

HRESULT OnToolAddBlock(
  BlockTypeEnum  Type,
  IFRRectangle*  BlockRect,
  VARIANT_BOOL** Cancel
);

​
C#

void OnToolAddBlock(
  BlockTypeEnum Type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);

​
Visual Basic .NET

Sub OnToolAddBlock( _
  Type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)

​
Parámetros

Type [in] Contiene el tipo del bloque. Consulte la descripción de las constantes de BlockTypeEnum. BlockRect [in] Contiene las coordenadas del bloque en píxeles. Las coordenadas se representan mediante el objeto FRRectangle. Las coordenadas son relativas a la imagen del documento. Cancel [out] Puede establecer esta variable en TRUE para indicar que el proceso debe interrumpirse. En este caso, no se creará el bloque.

​
Valores de retorno

[Solo para C++] Si este método devuelve un valor distinto de S_OK, significa que se produjo un error en el 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 imprevisibles (como la finalización del programa).

​
Consulte también

IZoomViewerEvents