Método OnProgress de la interfaz IZoomViewerEvents

Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama durante el análisis o el reconocimiento de la página activa en Zoom Viewer. El proceso puede invocarse de una de las siguientes formas:

• mediante los siguientes comandos de Zoom Viewer:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Para ver cómo se pueden llamar estos comandos, consulte la lista Zoom Viewer Commands.

• mediante los siguientes comandos de Image Viewer, sincronizado con Zoom Viewer:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Para ver cómo se pueden llamar estos comandos, consulte la lista Image Viewer Commands.

• mediante los comandos de Document Viewer, sincronizado con Image Viewer:
  • MI_Read
  • MI_AnalyzeLayout

Para ver cómo se pueden llamar estos comandos, consulte la lista Document Viewer Commands.

• a través de la API de FineReader Engine

Proporciona al cliente el porcentaje aproximado de progreso de la operación. Su implementación puede mostrar un indicador de progreso. También puede procesar mensajes del sistema para ayudar a evitar que la aplicación deje de responder durante operaciones largas. Esto puede resultar útil en aplicaciones con interfaz de usuario. Con este método también es posible cancelar la operación.

​

Sintaxis

​

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] Contiene el porcentaje del trabajo realizado hasta el momento. Está en el intervalo de 0 a 100.

Cancel

[out] Puede establecer esta variable en TRUE para indicar que el proceso debe finalizar. En este caso, el proceso de análisis o reconocimiento se cancelará.

​

Valores de retorno

[Solo 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 considera el valor del parámetro Cancel.

​

Observaciones

La implementación del cliente de este método debe asegurarse de que todas las excepciones que se produzcan dentro del método se capturen y se controlen, y de 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).

​

Consulte también

ZoomViewer

IZoomViewerEvents