Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama desde algunos de los métodos del objeto FRDocument. Proporciona al cliente información sobre el porcentaje aproximado de progreso de la operación actual (carga de imágenes, análisis, reconocimiento, etc.). Su implementación puede mostrar un indicador de progreso, como se hace en ABBYY FineReader.
En Windows, también puede procesar mensajes del sistema para ayudar a evitar que la aplicación deje de responder durante operaciones largas. Esto puede ser útil en aplicaciones con una interfaz de usuario.
HRESULT OnProgress(
IFRDocument* Sender,
int Percentage,
VARIANT_BOOL* Cancel
);
void OnProgress(
IFRDocument Sender,
int Percentage,
ref bool Cancel
);
Sub OnProgress( _
Sender As IFRDocument, _
Percentage As Integer, _
ByRef Cancel As Boolean _
)
Sender
[in] Este parámetro hace referencia al objeto FRDocument, que envía notificaciones.
Percentage
[in] Este parámetro contiene el porcentaje de trabajo completado hasta el momento. Está en el intervalo de 0 a 100.
Cancel
[in, out] Puede establecer esta variable en TRUE para indicar que el proceso debe detenerse. En este caso, la función de procesamiento devuelve E_ABORT.
[Solo para C++] Si este método devuelve un valor distinto de S_OK, significa que se produjo un error del lado del cliente y, en ese caso, no se tiene en cuenta el valor del parámetro Cancel.
La implementación cliente de este método debe garantizar que todas las excepciones que se produzcan dentro del método se capturen y gestionen, y que no se propague ninguna excepción fuera del método. La propagación de una excepción fuera del método puede dar lugar a resultados impredecibles (como la finalización del programa).
IFRDocumentEvents
FRDocument