可连接对象的处理

ABBYY FineReader Engine 中的有些对象是所谓的“可连接对象”。这意味着它们可实现 IConnectionPointContainer 接口。可连接对象支持 ABBYY FineReader Engine 及其客户端通信。

每个 ABBYY FineReader Engine 可连接对象都可提供两种类型的连接点，其中一个使用调度接口，另一个使用 IUnknown 派生的接口。调度接口在 Visual Basic 和类似环境中自动投入使用，而基于 vtbl 的接口适合在 C++ 中使用。

ABBYY FineReader Engine 的可连接对象及其对应回调接口列表如下 (dispinterfaces)：

对象	回调接口 (Dispinterface)
FRDocument	IFRDocumentEvents (DIFRDocumentEvents)
FRPages	IFRPagesEvents (DIFRPagesEvents)
FRPage	IFRPageEvents (DIFRPageEvents)
ImageDocument	IImageDocumentEvents (DIImageDocumentEvents)

可视化组件

对象	回调接口 (Dispinterface)
ImageViewer	IImageViewerEvents (DIImageViewerEvents)
ZoomViewer	IZoomViewerEvents (DIZoomViewerEvents)
DocumentViewer	IDocumentViewerEvents (DIDocumentViewerEvents)
TextEditor	ITextEditorEvents (DITextEditorEvents)
TextValidator	ITextValidatorEvents (DITextValidatorEvents)
ComponentSynchronizer	IComponentSynchronizerEvents (DIComponentSynchronizerEvents)
Commands	ICommandEvents (DICommandEvents)

如要在 ABBYY FineReader Engine 客户端应用程序中接收 ABBYY FineReader Engine 特定事件的通知，则应该实现特定类型的接口，并通过"advise" 方法将实现这些接口的对象与相应的可连接对象连接。

开发工具的详细信息如下：

Visual Basic .NET 代码

只需宣告可连接对象 WithEvents 和实施相应回调接口的方法。您还需要明确指定和事件关联的事件处理程序。

对于 FRDocument 对象，处理过程应该如下：

宣告 FRDocument 对象 WithEvents:

Private WithEvents document As FREngine.FRDocument

在 Sub 中实现 DIFRDocumentEvents 调度接口的必要方法，以下方子文档为例

如果您想要在程序执行期间随时开启和停止事件处理（使用 AddHandler 和 RemoveHandler 语句）：

Private Sub document_RecognitionOnProgress(ByVal sender As FREngine.FRDocument, _
                                           ByVal Percentage As Integer, _
                                           ByRef cancel As Boolean)
...
End Sub

或仅指定该过程用于特定事件处理（定义时使用 Handles 关键词）：

Private Sub document_RecognitionOnProgress(ByVal sender As FREngine.FRDocument, _
                                           ByVal Percentage As Integer, _
                                           ByRef cancel As Boolean) Handles document.OnProgress
...
End Sub

连接已实施的事件处理程序到事件源，使用 FRDocument 对象来处理，然后断开处理程序：

document = Engine.CreateFRDocument
document.AddImageFile("D:\Demo.tif")
AddHandler document.OnProgress, AddressOf Me.document_RecognitionOnProgress
document.Process()
RemoveHandler document.OnProgress, AddressOf Me.document_RecognitionOnProgress
// 或简单使用 FRDocument 对象进行 处理，如果 用 Handles 关键字定义 事件 处理方法：
document = Engine.CreateFRDocument
document.AddImageFile("D:\Demo.tif")
document.Process()

C++ 代码

在 C++ 中，您需要实现所需的接口，获取连接点，并使用”advise“将实施这些接口的对象与相应的可连接对象连接。我们将以 FRDocument 对象为例。

实现 IFRDocumentEvents 接口。因为该接口源自 IUnknown 接口，客户端对象应该也使用 IUnknown 方法：

class CFRDocumentEventsListener : public IFRDocumentEvents {
public:
...
    // 提供 IUnknown 方法的简单实例。它们也可以
    // 通过继承一些有 COM 支持的标准类别来实现 
    ULONG AddRef();
    ULONG Release();
    HRESULT QueryInterface(REFIID riid, void** ppvObject)
    {
        if( ppvObject == 0 )
            return E_INVALIDARG;
        if( riid == __uuidof(IFRDocumentEvents) ) {
            *ppvObject = static_cast<IFRDocumentEvents*>( this );
        } else if( riid == IID_IUnknown ) {
            *ppvObject = static_cast<IUnknown*>( this );
        } else {
            *ppvObject = 0;
            return E_NOINTERFACE;
        }
        AddRef();
        return S_OK;
    }
    // 提供 IFRDocumentEvents 方法实现
 HRESULT STDMETHODCALLTYPE OnProgress(
  IFRDocument* sender, int percentage, VARIANT_BOOL* cancel );
 HRESULT STDMETHODCALLTYPE OnWarning(
  IFRDocument* sender, int index, BSTR tip, VARIANT_BOOL* cancel );
 HRESULT STDMETHODCALLTYPE OnPageProcessed(
  IFRDocument* sender，int index, PageProcessingStageEnum stage ) { return S_OK; }
};

然后 CFRDocumentEventsListener 类别可用来接收来自 FRDocument 对象的通知。将该对象与通知源连接（忽略错误处理）：

// 假设我们已经接收到 FRDocument 对象
IFRDocument* document;
// 对于 FRDocument 对象的 IConnectionPointContainer 的查询
IConnectionPointContainer* pContainer=0;
document->QueryInterface(IID_IConnectionPointContainer, (void**)&pContainer);
// 获取可连接对象内连接点上的 IConnectionPoint 接口指针
IConnectionPoint* pPoint=0;
pContainer->FindConnectionPoint(__uuidof(IFRDocumentEvents),
                                &pPoint);
// 在 CFRDocumentEventsListener 类别和连接点之间建立连接
CFRDocumentEventsListener listener;
IUnknown* listenerUnknown=0;
listener.QueryInterface(IID_IUnknown, (void**)&listenerUnknown);
// 将侦听器与通知源连接
DWORD cookie; // IConnectionPoint::Advise 方法返回的一个存储 cookie 变量
pPoint->Advise(listenerUnknown, &cookie);
// 处理文档
...
// 通知后，侦听器不再被需要，应该断开其连接
pPoint->Unadvise(cookie);

C# 代码

有关可连接对象的更详细说明，请参阅关于 COM 的相关文档。

您也可以参考提供给 C#、支持Native COM 的 C++、 raw C++、 Visual Basic .NET 的 EventsHandling 示例。

24.03.2023 8:51:52

Your use of this site is conditioned on Your continued compliance with the Terms of Use.

Terms of Use

Disclaimer of Warranty

Limitation of Liability

Transmission and Submission of Information

Downloads

Use of Content

Trademarks

Links to Third-Party Sites

Foreign Legislation

Subscription Terms

Partner Subscription Terms

可连接对象的处理

Visual Basic .NET 代码

C++ 代码

C# 代码