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

本文链接：https://blog.csdn.net/LifeRiver/article/details/125948823

本文档详细介绍了如何在Qt环境中通过Ocx调用CZUR扫描仪SDK，实现对非TWAIN协议扫描仪的支持。首先，需要安装OCX插件并使用dumpcpp生成Qt头文件。接着，初始化COM库，并创建CZUROcx对象，调用相应接口进行设备初始化和打开。同时，利用Qt的信号和槽机制处理扫描仪事件，如图像抓拍和显示。这为Qt应用增加了扫描仪功能，适用于需要集成扫描功能的桌面应用开发。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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

项目背景

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

开发步骤

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

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

在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);
     }
  }