Saltar al contenido principal
Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama antes de agregar un nuevo bloque que se haya dibujado con una de las siguientes herramientas de Image Viewer: Consulte la descripción de Image Viewer Commands para saber cómo seleccionar estas herramientas. Este método proporciona al cliente información sobre el bloque dibujado: su tipo y la región. Con este método, 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. Las coordenadas se representan mediante el objeto FRRectangle. Se especifican en píxeles con respecto a la imagen del documento. Cancel [out] Puede establecer esta variable en TRUE para indicar que debe finalizarse el proceso. 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, indica que se produjo un error del lado del cliente y, en ese caso, no se tiene en cuenta el valor del parámetro Cancel.

​
Observaciones

La implementación del 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 propague ninguna excepción fuera del método. 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

IImageViewerEvents