Este método é implementado no lado do cliente. Ele é chamado pelo ABBYY FineReader Engine por alguns dos métodos do objeto FRDocument. Ele envia ao cliente dicas e avisos ocorridos durante o processamento.
No Windows, ele também pode processar mensagens do sistema para ajudar a evitar que o aplicativo pareça não responder durante operações longas. Isso pode ser útil em aplicativos com interface do usuário.
HRESULT OnWarning(
IFRDocument* Sender,
int PageIndex,
BSTR Warning,
VARIANT_BOOL* Cancel
);
void OnWarning(
IFRDocument Sender,
int PageIndex,
string Warning,
ref bool Cancel
);
Sub OnWarning( _
Sender As IFRDocument, _
PageIndex As Integer, _
Warning As String, _
ByRef Cancel As Boolean _
)
Sender
[in] Refere-se ao objeto FRDocument que envia notificações.
PageIndex
[in] Este parâmetro contém o índice da página à qual a dica ou o aviso se refere. A mensagem pode se referir não apenas a uma única página, mas ao documento inteiro. Nesse caso, o valor do parâmetro é -1.
Warning
[in] Contém a dica ou o aviso.
Cancel
[in, out] Você pode definir esta variável como TRUE para indicar que o processo deve ser interrompido. Nesse caso, a função de análise ou reconhecimento que emite a dica retorna E_ABORT.
[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 será considerado.
A implementação do 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 dele. A propagação de uma exceção para fora do método pode levar a resultados imprevisíveis (como o encerramento do programa).
IFRDocumentEvents
FRDocument