Pular para o conteúdo principal
Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine antes de alterar um bloco de tabela que foi modificado usando uma ferramenta do Image Viewer: Consulte a descrição dos Comandos do Image Viewer para saber como essas ferramentas podem ser selecionadas. Ele fornece ao cliente o índice do bloco de tabela que será alterado, bem como a posição e o tipo do novo separador ou do separador excluído. Com este método, é possível cancelar a operação.

Sintaxe

C++

HRESULT OnToolChangeTable(
  int           BlockIndex,
  int           Position,
  VARIANT_BOOL  IsVerticalSeparator,
  VARIANT_BOOL  DeleteSeparator,
  VARIANT_BOOL* Cancel
);

C#

void OnToolChangeTable(
  int      BlockIndex,
  int      Position,
  bool     IsVerticalSeparator,
  bool     deleteSeparator,
  out bool Cancel
);

Visual Basic .NET

Sub OnToolChangeTable( _
  BlockIndex As Integer, _
  Position As Integer, _
  IsVerticalSeparator As Boolean, _
  DeleteSeparator As Integer, _
  ByRef Cancel As Boolean _
)

Parâmetros

BlockIndex [in] Contém o índice do bloco de tabela que será modificado. O índice está na coleção ILayout::VisualBlocks. Position [in] Contém a posição do separador na tabela. A posição do separador é sua coordenada em uma grade base. IsVerticalSeparator [in] Especifica se o separador é vertical ou horizontal. DeleteSeparator [in] Especifica se o separador será excluído ou adicionado. Cancel [out] Você pode definir esta variável como TRUE para indicar que o processo deve ser encerrado. Nesse caso, o separador não será adicionado (ou excluído).

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 será desconsiderado.

Observações

  • Aqui, consideramos como grade base a grade formada pelas bordas e pelos separadores da tabela. Cada separador vertical incrementa a coordenada horizontal em uma unidade, e cada separador horizontal incrementa a coordenada vertical em uma unidade. Os eixos de coordenadas são orientados da esquerda para a direita e de cima para baixo.
  • A implementação do cliente desse 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