Qt扫描仪应用开发：通过 Ocx 调用CZUR扫描仪 SDK

Qt扫描仪应用开发：通过 Ocx 调用CZUR扫描仪 SDK

项目背景

1. Qt 5.12.12 + QML
2. 已支持标准TWAIN协议，需要通过SDK兼容其他扫描仪
3. 扫描仪厂家提供 Ocx 插件安装包及授权码

开发步骤

1. 安装插件，找到.ocx 文件
2. （非必须）使用 oleview.exe（C:\Program Files (x86)\Windows Kits\8.1\bin\x86\）可以打开.ocx 查看接口及事件。
3. 通过Qt安装目录下 dumpcpp.exe 生成Qt应用开发所需的头文件。

打开cmd(管理员身份运行)，进入.ocx所在文件夹
D:\Qt\5.12.12\mingw73_32\bin\dumpcpp.exe .\CZUROcx.ocx
生成：czurocxlib.h + czurocxlib.cpp

4. 在Qt中调用接口及处理事件

• 添加依赖模块：QT += axcontainer
• 初始化组件对象模型（COM）库

   HRESULT r = OleInitialize(0);
   CoInitialize(0);
   if (r != S_OK && r != S_FALSE) {
       qDebug()<<"Qt: Could not initialize OLE";
   }

• 参考接口说明文档调用接口

	m_CZUROcx = new CZUROcxLib::CZUROcx();
	m_CZUROcx->m_CZUROcx->CZUR_Initialize(bsrLicense);
    m_CZUROcx->CZUR_OpenDevice();

• 通过信号+槽进行事件处理

    // 通过sigal 信号可以监听所有事件，打印事件名
    QObject::connect(m_CZUROcx, SIGNAL(signal(const QString&,int,void*)), this, SLOT(printSignal(const QString&,int,void*)));
    //  监听抓拍事件并抓拍
    QObject::connect(m_CZUROcx, SIGNAL(CZUR_EVENT_GRAB(int)), this, SLOT(slot_grab(int)));
    //  监图像事件并展示存储图片
    QObject::connect(m_CZUROcx, SIGNAL(CZUR_EVENT_IMAGE(int,QString,QString,int,QString)), this, SLOT(slot_getImage(int, QString,QString,int,QString)));

• 备注，信号 signal(const QString&,int,void*)参数说明， 参考:https://doc.qt.io/qt-5/qaxbase.html#signal

   // 可在signal()对应槽中统一处理信号
   slot_printSignal(const QString &name, int argc, void* argv) {
     qDebug()<<"-----"<<name;
     if (name.indexOf("CZUR_EVENT_IMAGE")>=0) {
        VARIANTARG *params = (VARIANTARG*)argv;
        int error = params[argc-1].intVal;  // 注意参数顺序
        // BSTR 转为 QString
        QString file = QString::fromWCharArray((wchar_t *)params[argc-2].bstrVal);
     }
  }