通八洲科技

Qt创建动态库给C#调用,通过回调完成交互

日期:2025-07-09 00:00 / 作者:星夢妙者

1. 前言

在windows下做应用开发时,经常需要多种不同的语言混合编程。比如:利用qt开发一个动态库,给c#调用。

当前的需求是: 利用Qt开发一个工具库,给C#调用,来完成一些特殊处理。

需要Qt生成一个动态库(dll),给C#加载调用,并且还需要设置回调,方便C#知道Qt运行时,输出内部的一些实时消息。 这个Qt库是不需要界面的,只是一个单纯的库,提供方法给C#调用,完成指定的功能即可。

比如:视频加水印,图片模糊处理,图片镜像,视频特效等等。

接下来就利用一个小Demo来演示一下整个流程。

当前我的开发环境:

代码语言:javascript代码运行次数:0运行复制
VS版本:  VS2017Qt版本:  Qt5.12.6 

在此之前,需要先给vs2017搭建QT的环境,也就是安装Qt插件。这个流程在之前的文章里已经有详细介绍,可以翻阅。

Demo工程案例下载: https://download.csdn.net/download/xiaolong1126626497/86404349

2. 创建Qt项目2.1 新建工程

到此,工程模板创建成功。

2.2 编写函数接口

为了外部能够调用,需要提供函数接口给外部调用,我这里采用编写个简单的Demo来进行演示。

我这里写了1个接口,这个接口用于图片的缩放,形参里最后一个参数是设置回调函数指针,用于回调给C#输出一些提示,一些其他数据。

代码语言:javascript代码运行次数:0运行复制
//回调函数指针typedef void(*CallBackFunction_p)(const char *p);//图片缩放接口extern "C" _declspec(dllimport) int ImageZoom(int w,int h,char* image_path,CallBackFunction_p func_p);

.h文件新增的代码如下:

因为要处理图片,这里加入Qt需要使用的头文件。

.c文件新增代码如下:

代码语言:javascript代码运行次数:0运行复制
QString __NewFile;//图片缩放接口int ImageZoom(int w, int h, char* image_path, CallBackFunction_p func_p){QImage img(image_path);QImage result = img.scaled(w,h, Qt::IgnoreAspectRatio, Qt::SmoothTransformation);__NewFile = QString("%1_zoom.png").arg(QFileInfo(image_path).baseName());int state=result.save(__NewFile);//调用回调,通知C#新图片生成的路径func_p(__NewFile.toStdString().c_str());return state;}
2.3 编译生成动态库

编译成功后生成的库文件如下:

2.4 打包依赖文件

生成库之后,不能直接拿去调用,还需要找到这个库所需要的其他库文件,放到一起再拷贝到C#目录下,才可以正常调用运行。

因为我用的是32位编译器编译的库,点击windows状态栏左下角的window图标,弹出选项栏,找到对应的控制台,点击进入。

代码语言:javascript代码运行次数:0运行复制
C:\Qt\Qt5.12.6\5.12.6\msvc2017>cd /d D:\out\VS2017_Test\QtClassLibrary1\ReleaseD:\out\VS2017_Test\QtClassLibrary1\Release>windeployqt.exe QtClassLibrary1.dll

利用Qt的windeployqt.exe 工具,自动搜索拷贝依赖库。

依赖库搜索完成。

3. 创建C#项目3.1 新建工程

创建好的工程模板如下:

3.2 编写代码调用Qt接口代码语言:javascript代码运行次数:0运行复制
using System;using System.Collections.Generic;using System.ComponentModel;using System.Data;using System.Drawing;using System.Linq;using System.Text;using System.Threading.Tasks;using System.Runtime.InteropServices;namespace ConsoleApp1{    class Program    {        [DllImport("QtClassLibrary1.dll", EntryPoint = "ImageZoom", CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Auto)]        public extern static int ImageZoom(int w,int h,IntPtr Path, CallbackDelegate callback);        //定义委托        [UnmanagedFunctionPointer(CallingConvention.Cdecl)]        public delegate void CallbackDelegate(IntPtr Path);        //接收C++回调数据        static void CallBackFunction(IntPtr Path)        {            Console.WriteLine("C++传出来的回调:" + Marshal.PtrToStringAnsi(Path));        }        static void Main(string[] args)        {            string text = "C:\\Users\\11266\\Pictures\\20250425103841.png";            int r_code = ImageZoom(100,100,Marshal.StringToHGlobalAnsi(text), CallBackFunction);            Console.WriteLine("执行状态:" + r_code);            Console.ReadKey();        }    }}

写完代码,直接运行,会报错找不到模块。很正常,因为代码里填写的库是当前程序运行路径,现在路径下并没有库文件,接下来需要拷贝库到运行目录下即可。

3.3 拷贝库文件
3.4 再次运行

图片已经缩放成功:

到此,C#调用Qt生成的库调用完成。

4. 信号槽的问题

如果在库里面需要使用到Qt信号与槽函数,需要手动启用事件循环。

定义一个全局变量,初始化QCoreApplication

代码语言:javascript代码运行次数:0运行复制
static int argc = 1;static char arg0[] = "";static char * argv[] = { arg0, nullptr };QCoreApplication app(argc, argv);

然后在需要启动事件循环的地方,执行:

代码语言:javascript代码运行次数:0运行复制
//开始事件转换app.exec();

在合理的地方进行退出,事件循环: (比如:槽函数响应里)

代码语言:javascript代码运行次数:0运行复制
app.quit();

贴出个定时器例子:

代码语言:javascript代码运行次数:0运行复制
#include #include static int argc = 1;static char arg0[] = "";static char * argv[] = { arg0, nullptr };QCoreApplication app(argc, argv);void MediaToolLibrary::update_time(){time_cnt++;if (time_cnt >= 5)app.quit();  //退出事件循环qDebug() << "时间进行中:" << time_cnt++;}//要素块导出void MediaToolLibrary::VideoElementExport(QString MediaInfo, CallBackFunction_p func_p){time_cnt = 0;timer = new QTimer(this);connect(timer, SIGNAL(timeout()), this, SLOT(update_time()));timer->start(1000);    //开始事件转换app.exec();qDebug() << "时间到达.....";}