Pular para o conteúdo principal
Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine antes de alterar uma região do bloco que foi modificada por meio de uma das seguintes ferramentas do Image Viewer: Consulte a descrição de Image Viewer Commands para saber como essas ferramentas podem ser selecionadas. Ele fornece ao cliente informações sobre os blocos cujas regiões foram alteradas, bem como a nova região do bloco resultante. O método é chamado para cada bloco resultante. Por exemplo, se duas regiões tiverem sido unidas em um bloco, o método será chamado apenas uma vez. Se regiões de dois blocos tiverem sido recortadas usando uma ferramenta, o método será chamado duas vezes. Se um bloco tiver sido excluído usando uma ferramenta, o método não será chamado. 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,
  IRegion         NewRegion,
  out bool       Cancel
);

​
Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)

​
Parâmetros

BlocksToChange [in] Contém os índices dos blocos alterados no objeto IntsCollection. A coleção contém mais de um elemento somente se vários blocos tiverem sido mesclados em um único bloco. 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 no 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 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 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