Pular para o conteúdo principal
Este método é implementado no cliente. Ele é chamado pelo ABBYY FineReader Engine durante a análise ou o reconhecimento da página ativa no Document Viewer. O processo pode ser iniciado de uma das seguintes maneiras: Para saber como esses comandos podem ser chamados, consulte a lista Document Viewer Commands. Para saber como esses comandos podem ser chamados, consulte a lista Image Viewer Commands. Para saber como esses comandos podem ser chamados, consulte a lista Zoom Viewer Commands.
  • via API do FineReader Engine
Ele fornece ao cliente a porcentagem aproximada de andamento da operação. Sua implementação pode exibir um indicador de progresso. Processe todas as mensagens do sistema para ajudar a evitar que o aplicativo fique sem resposta durante operações longas. Isso pode ser útil em aplicativos com interface de usuário. Com a ajuda deste método, é possível cancelar a operação.

​
Sintaxe

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​
Parâmetros

Percentage [in] Contém o percentual do trabalho concluído até o momento. Ele varia de 0 a 100. Cancel [out] Você pode definir essa variável como TRUE para indicar que o processo deve ser encerrado. Nesse caso, o processo de análise ou reconhecimento será abortado.

​
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 é considerado.

​
Observações

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

DocumentViewer IDocumentViewerEvents