Pular para o conteúdo principal
Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine antes de alterar a página ativa no Document Viewer. O método é acionado se a página for alterada pela interface gráfica do usuário do Document Viewer ou por qualquer componente sincronizado. Ele não é acionado se a página ativa for alterada pela API do Document Viewer ou se a página ativa tiver sido excluída. O método fornece ao cliente uma referência à nova página ativa. Com esse método, é possível cancelar a operação.

​
Sintaxe

​
C++

HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);

​
C#

void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)

​
Parâmetros

Page [in] Refere-se ao objeto FRPage que contém a nova página ativa. Esse parâmetro pode ser NULL, o que significa que não há nenhuma página ativa no documento (por exemplo, se todas as páginas tiverem sido excluídas). Cancel [out] Você pode definir essa variável como TRUE para indicar que o processo deve ser interrompido. Nesse caso, a página ativa não será alterada.

​
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 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

IDocumentViewerEvents