Pular para o conteúdo principal
Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine antes de alterar a região de um bloco modificado no Zoom Viewer com uma das seguintes ferramentas do Image Viewer: Consulte a descrição dos Comandos do Image Viewer para saber como essas ferramentas podem ser selecionadas. Ele fornece ao cliente informações sobre os blocos cujas regiões foram alteradas e sobre a nova região do bloco resultante. Com este método, é possível cancelar a operação.

​
Sintaxe

​
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] Contém os índices dos blocos alterados no objeto IntsCollection. NewRegion [in] Contém a nova região do bloco resultante no objeto Region. Cancel [out] Você pode definir esta variável como TRUE para indicar que o processo deve ser interrompido. Nesse caso, as regiões dos blocos não serão alteradas.

​
Valores de retorno

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

​
Observações

A implementação cliente deste 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 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

IZoomViewerEvents