Pular para o conteúdo principal
Este método é implementado no cliente. Ele é chamado pelo ABBYY FineReader Engine antes da adição de um novo bloco desenhado com uma das seguintes ferramentas do Visualizador de Imagem: Consulte a descrição dos Comandos do Visualizador de Imagem para saber como essas ferramentas podem ser selecionadas. Ele 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

type [in] Contém o tipo do bloco. Consulte a descrição das constantes BlockTypeEnum. BlockRect [in] Contém as coordenadas do bloco. As coordenadas são representadas pelo objeto FRRectangle. As coordenadas são especificadas em pixels, relativamente à imagem do documento. Cancel [out] Você pode definir esta 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 no cliente e, nesse caso, o valor do parâmetro Cancel não será considerado.

​
Observações

A implementação do cliente deste método deve garantir que todas as exceções geradas dentro do método sejam capturadas e tratadas, e que nenhuma exceção seja propagada para fora dele. 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

IImageViewerEvents