IFRPageEvents Interface

This is a callback interface that is used for reporting events from the FRPage object to the listeners. This interface is implemented on the client-side. See the detailed implementation advice for your development tool in Working with Connectable Objects. Below you can find a short summary.

In C++ you need to implement the IFRPageEvents interface, obtain a connection point, and "advise" object implementing the interface to the FRPage object. As the interface is derived from the IUnknown interface, the client object should also implement the IUnknown methods.

Visual Basic users that want to receive notifications from the FRPage object should declare it WithEvents and implement the procedures similar to the following:

Public WithEvents page As FREngine.FRPage
Private Sub page_OnPageProcessed(ByVal sender As FRPage, _
                                 ByVal stage As PageProcessingStageEnum)
...
End Sub
    

An object receiving notifications through this interface's methods may do the following inside the methods' implementation:

  • Process any Windows messages, which is useful in applications having User Interface, to avoid the effect that the application "is not responding" during long operations.
  • Report percentage of document analysis, recognition, and export.
  • Report recognizer tips and warnings to the user.
  • Report information about completion of the operation.

Methods

Name Description
OnPageProcessed Delivers to the client information about page processing completed.
OnProgress Delivers to the client information about approximate percentage of the current operation (analysis, recognition, and export).
OnRegionProcessed Delivers to the client information about region which is processed.
OnWarning Delivers to the client tips and warnings which occurred during processing.

See also

FRPage

Working with Connectable Objects

17.09.2024 15:14:40

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.