Pular para o conteúdo principal
Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine antes de adicionar um novo bloco desenhado no Zoom Viewer usando uma das seguintes ferramentas do Image Viewer: Consulte a descrição de Image Viewer Commands para saber como essas ferramentas podem ser selecionadas. Esse método fornece ao cliente informações sobre o bloco desenhado: seu tipo e sua região. Com este método, é possível cancelar a operação.

​
Sintaxe

​
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

Tipo [in] Contém o tipo do bloco. Consulte a descrição das constantes BlockTypeEnum. BlockRect [in] Contém as coordenadas do bloco em pixels. As coordenadas são representadas pelo objeto FRRectangle. Elas são relativas à imagem do documento. Cancel [out] Você pode definir essa variável como TRUE para indicar que o processo deve ser interrompido. Nesse caso, o bloco não será criado.

​
Valores de retorno

[Somente C++] Se este método retornar um valor diferente de S_OK, isso indica que ocorreu um erro do lado do cliente e, nesse caso, o valor do parâmetro Cancel não será considerado.

​
Observações

A implementação do cliente desse método deve garantir que todas as exceções lançadas dentro do método sejam capturadas e tratadas, e que nenhuma exceção seja propagada para fora do método. A propagação de uma exceção para fora do método pode levar a resultados imprevisíveis (como o encerramento do programa).

​
Veja também

IZoomViewerEvents