QtE56快速入门指南.
下面方案是按Windows术语描述的.对Linux,文件名为libXXXX.so,还应考虑32位或64位位深实现.如有Qt64位,则库(so/dll文件)也必须是64位.
示例:
QtE56core32.dll---32位Windows实现
libQtE56core64.so---64位Linux实现架构:
QtXX(*.dll)--->,`dll/so`文件集,`XX`为位大小
|
+----- |qte56coreXX.dll |基本原语
+----- |qte56widgetsXX.dll |组件
| |
| + QtE56.d ---> D绑定
| |
| + app.d ---> D应用
|
+ QtE56.cpp ---> C++绑定
|
+ app.cpp --->C++应用注意,Qt可按不同编译器表示(编译),如MINGW或MSVC.为了简单,QtE56在Windows上仅用MINGW,在Linux上用gcc.也可用msvc编译,但未详细测试.
构建QtE56:
最重要的是构建qte56coreXX.dll/so和qte56windowsXX.dll/so文件(其中XX是32/64).为此,切换至build/qte56文件夹.里面有*.pro(Qt),*.cpp,*.h构建QtE56所必需的(qte56coreXX.dll/so,qte56widgetsXX.dll/so)源文件.现在用Qt的C++编译器,构建所需文件.
Linux最简单的选择:
$ cd build/qte56
$ qmake-qt5 qte56core.pro
$ make输出为qte56coreXX.so
类似,可为Windows构建文件.可用QtCreator来构建他们,主要是创建qte56coreXX.dll/so和qte56windowsXX.dll/so(其中XX为32/64).
构建遇到问题之一是多种多样的Qt版本,类中方法和属性集不同.我不知道如何解决它.当前我专注于Qt6,如果用另一个Qt版本,构建中出错,只会注释掉带有此错误的代码行.这样禁用,会导致qte56.d调用方法之一停止工作.目前调用禁止方法,没法使其崩溃.
Qt库路径.
现在目录中有三个文件(qte56coreXX.dll/so+qte56windowsXX.dll/so+qte56.d),可开始用D和Qt创建应用.但是,还有个问题.应用要求qte56.d加载qte56coreXX.dll/so和qte56windowsXX.dll/so到内存中,而他们(dll)要加载其他Qt*.dll/so,如果失败,会收到错误消息.
为确保成功加载,(如已经安装了Qt)需要将Qt*.dll/so文件路径放在PATH环境变量中,或复制所需的Qt*.dll/so文件到我们包含三个文件的目录中.对于Windows,复制少量Qt*.dll文件就行.而linux上要置LD_LIBRARY_PATH变量来指定加载库的额外目录.
在Linux上构建和运行典型应用示例:
$ export LD_LIBRARY_PATH=`pwd`
$ dmd app.d qte56.d -release -m64
$ ./app第一个应用.
现在已经配置好了,来创建第一个应用.这将是对QtE56的一种健康测试.
创建test.d文件:
import core.runtime,qte56;
int main(string[] args) {
if(LoadQt(dll.QtE6Widgets, false)) return 1;
QApplication app = new QApplication(&Runtime.cArgs.argc,
Runtime.cArgs.argv, 1);
QLabel lb = new QLabel(null);
lb.setText("Hello from D").show();
return app.exec();
}编译并运行
$ export LD_LIBRARY_PATH=`pwd`
$ dmd test.d qte56.d -release -m64
$ ./test如果屏幕上有应用窗口了,则能创建和执行D+Qt应用了.
插槽和信号.
查看QtE56中插槽和信号模型前,我想说几点:
QtE56是庞大的Qt框架的很小子集.
实现QtE56时,我尽量保留Qt的类结构,类名,方法和属性及Qt的工作模型.
QtE56中实现类的所有标准信号和槽都可用.
要理解QtE56,就要理解Qt的工作原理.
多数情况下,Qt的标准文档对QtE56类也管用.
让我们看看QtE56插槽和信号模型,与Qt相比,实现的根本区别.
最重要区别.标准Qt模型期望,在编译C++源代码时创建插槽.插槽自身是类方法.得到数量就是,加了多少方法(槽)给类.QtE56用不同的方法,即用QAction类的修改版本,作为两个集插槽的存储库.有20%的不同插槽,涵盖了需要的80%的选项.
QtE56中可用插槽.
| 函数原型 |
| void call(AdrClass, Nnumber); |
| void call(AdrClass, Nnumber, int); |
| void call(AdrClass, Nnumber, int, int); |
| void call(AdrClass, Nnumber, int, int, int); |
| void call(AdrClass, Nnumber, bool); |
| void call(AdrClass, Nnumber, |
如果愿意,总可向C++加新变体,但很少见.一个难点是Qt检查信号和槽参数数量和类型.因此,必须增加不同插槽变体数来满足Qt限制.
好的.通过创建QAction action = new QAaction(...);,我们得到了实际存储槽集的动作.这样,可创建插槽信号链接,类似:
连接(按钮,"点击()",动作,"Slot_AN()");
连接(按钮,"按下(int)",动作,"Slot_ANI(int)");
//e
conect(button, "clicked()", action, "Slot_AN()");
conect(button, "press(int)", action, "Slot_ANI(int)");有了想要槽的Qaction类实例,可关联信号与槽.
看看下面示例:
创建test1.d文件:
import core.runtime, qte56;
extern (C) { // (1)
// (2)
void onAction(void* uk, int n) {
runAction();
}
}
// (3)
void runAction() { // this is slot
msgbox("applicationDisplayNameChanged() ...");
}
QAction acAction;
int main(string[] args) {
if(LoadQt(dll.QtE6Widgets, false)) return 1;
QApplication app = new QApplication(&Runtime.cArgs.argc,
Runtime.cArgs.argv, 1);
QLabel lb = new QLabel(null);
lb.resize(640, 480);
lb.setText("Hello from D").show();
// 用槽创建动作
// (4)
acAction = new QAction(null, &onAction, &app, 2);
// 连接`标准信号`与`QAction`中插槽
// (5)
acAction.connects(app, "applicationDisplayNameChanged()", acAction, "Slot_AN()");
//生成标准信号
// (6)
app.setApplicationDisplayName!string("newNameApp");
return app.exec();
}编译并运行
$ dmd test1.d qte56.d -release -m64
$ ./test1该例中,看看如何连接标准Qt信号与基于我们QAction的槽.四标签–创建新QAction.构造器接受四个参数:
父.一般为null或this.这里为null,因为无父.
触发槽(抓到信号)时,调用函数的C地址.该例为onAction().
槽处理方法所在类实例的地址.本例中,为任何地址,因为未用它.
int值(数字).该数字存储在每个特定的QAction实例中,调用函数会检索它,该例为onAction().
查看插槽列表(QtE56中可用插槽列表).会在1号处看见我们槽如何调用C代码(标签2).具体调用描述是带正确参数的onAction(...)调用.
连接函数(标签5)允许关联信号与插槽.这是标准Qt函数.该函数有四个参数:
对象,信号发射器
信号符号描述
对象,插槽物主
插槽符号说明
例子中,用"Slot_AN()"的acAction动作关联applicationDisplayNameChanged应用.现在,发射"applicationDisplayNameChanged()“信号时,激活特定的acAction:”Slot_AN()"槽.激活并调用onAction(...)函数(标记2),2函数调用runAction(...)函数(标记3).现在,要准备激活信号自身.由一行改变应用名的(标签6)完成,因此生成了用插槽抓它的信号.
看一下处理槽和信号的最标准源代码布局.这是包含Qt可视元素类及处理信号的方法(槽)的简单应用.
创建test2.d文件
import core.runtime, qte56;
extern (C) {
// (1)
void onAction(CMyWidget* uk, int n) {
(*uk).runAction();
}
}
class CMyWidget : QWidget {
QLabel lb;
QPushButton kn;
QAction acAction;
this(QWidget parent) {
super(null); resize(300, 130);
lb = new QLabel(this);
lb.resize(300, 50).setStyleSheet("background: pink");
kn = new QPushButton("Press Me", this);
kn.move(110, 60).resize(80, 30);
// (2)
acAction = new QAction(this, &onAction, aThis);
// (3)
connects(kn, "clicked()", acAction, "Slot_AN()");
}
// (4)
void runAction() {
lb.setText("按了个按钮...");
}
}
int main(string[] args) {
if(LoadQt(dll.QtE6Widgets, false)) return 1;
QApplication app = new QApplication(&Runtime.cArgs.argc,Runtime.cArgs.argv, 1);
// (5)
CMyWidget mw = new CMyWidget(null);
// (6)
mw.saveThis(&mw);
mw.show();
return app.exec();
}编译并运行:
$ export LD_LIBRARY_PATH=`pwd`
$ dmd test2.d qte56.d -release -m64
$ ./test2仔细看看该例.主要区别是有个从QWidget继承的CMyWidget新类.构造器与前一样,很简单.看一下创建QAction(标签2).定义了三个参数(不是四个),因为第四个参数默认为零.第一个参数是父类(参见Qt文档),第二个参数是函数(代理)的C地址,第三个参数是允许从C函数传递控制到D类(标签1)的槽(方法)的类实例地址.
注意创建CMyWidget类实例行(标签5).父为空,无本,不用引用.及记住类实例地址(a)的非常重要一行(标签6),可通过aThis属性(标签2)读取a.
为何要使用额外的代理(C函数)?因为我们不仅希望QtE56与D编程语言一起使用,还希望与其他编程语言一起使用.我尝试将QtE56与forth和tcl一起使用.一切正常.
再看一个例子.这里拦截包含QString的信号.
创建test3.d文件
import std.stdio, std.conv;
import qte56, core.runtime;
extern (C) {
void onTest(CTest* uk, int n) { (*uk).runTest(); }
void onChTitle(CTest* uk, int n, void* qs) { (*uk).runChTitle(qs); }
}
class CTest: QWidget {
QPushButton kn1;
QAction acTest, acChTitle;
int nn;
this() {
super(null);
// Qt 文档
resize(200, 50); setStyleSheet("background: Moccasin");
kn1 = new QPushButton("点我", this);
// (1)
acTest = new QAction(this, &onTest, aThis);
connects(kn1, "clicked()", acTest, "Slot_AN()");
// (2)
acChTitle = new QAction(this, &onChTitle, aThis);
connects(this, "windowTitleChanged(QString)", acChTitle, "Slot_ANQS(QString)");
}
void runTest() { // slot ... (3)
setWindowTitle("Hello " ~ to!string(nn++));
}
void runChTitle(void* qs) { // slot ... (4)
QString qss = new QString('+', qs); // (5)
msgbox("cath signal: " ~ qss.String, "run slot ...");
}
}
int main(string[] args) {
if (1 == LoadQt(dll.QtE6Widgets, false)) return 1;
QApplication app = new QApplication(&Runtime.cArgs.argc, Runtime.cArgs.argv, 1);
CTest wn = new CTest(); wn.saveThis(&wn).show; // (6)
return app.exec();
}编译并运行:
$ export LD_LIBRARY_PATH=`pwd`
$ dmd test3.d qte56.d -release -m64
$ ./test3该例与上一个类似.唯一区别是我们拦截QString为参数的信号.串(标签1)定义了QAction和连接,帮助创建处理按钮操作插槽(标签3).槽用来改变窗口标题,从而使Qt生成"windowTitleChanged(QString)"信号.行(标签2)通过&onChTitle -- void onChTitle(...) -- *.runChTitle(qs) -- void runChTitle(void* qs)定义槽(4标签),来处理接收到改标题的信号.
行(标签5)很重要,它允许从来自Qt的QString指针的指针创建QtE56类,+构造器中第1参说,正在抓并保存来自Qt的QString指针到qss中.msgbox(...)函数只是使用qss.String显示生成串.
QtE56和Qt事件.
Qt框架中有大量事件.QtE56的事件处理程序数有限.可浏览qte56.d文件找到已实现的事件.用类处理事件.例子是QResizeEvent.可运行如下命令获得大概列表:
$ grep -E "\bQ(.*)vent" qte56.d事件类名示例:QResizeEvent,QWheelEvent,QMouseEvent等.既然有了事件类,就以按以下方法设置事件抓:setKeyPressEvent(...),setResizeEvent(...)等.可如下得到大概列表:
$ grep -E "\bset(.*)vent" qte56.d这些方法(事件抓置器)有两个参数.为adr(C函数代理地址)和AdrThis(包含事件处理器的类实例地址).
如何使用安装处理器示例:
...
extern (C) {
// (2)
void onPressKeyEvent(CMgw* uk, void* qs) { (*uk).runPressKeyEvent(qs); }
}
class CMyWidget: QWSidget {
...
QEdit teEdit;
...
teEdit = new QEdit(this);
teEdit.setKeyPressEvent(&onPressKeyEvent, aThis ); // (1)
...
void runPressKeyEvent(void* qs) { // (3)
QKeyEvent qe = new QKeyEvent('+', ev);
switch(qe.key) {
case '"': insParaSkobki("\""); break;
case '(': insParaSkobki(")"); break;
case '[': insParaSkobki("]"); break;
case '{': insParaSkobki("}"); break;
case QtE.Key.Key_Return:
strBeforeEnter = tb.text!string();
break;
case QtE.Key.Key_L:
if(qe.modifiers == QtE.KeyboardModifier.ControlModifier) {
editSost = Sost.Cmd;
}
break;
default: break;
}
}
...
CMyWidget w = new CMyWidget(null);
w.saveThis(&w);
...如果更仔细地检查代码,会发现许多与前面示例相同的元素.有个代理赋值(C函数)(标签1),及调用插槽(标签2).在参数中是有事件类实例之一指针的*void.及输入插槽(3标签),(按QtE56术语为创建正确的事件).等价于QKeyEvent qe=new QKeyEvent('+',ev);.
QtE56和Qt的QDesigner.
Qdesigner生成两种输出文件:
*.ui(描述表单,内为元素的xml文件).
*.qrc(Qt资源文件).``Qt资源编译器解析它并生成适合嵌入在D源代码中的二进制文件.
有特殊的QFormBuilder类来处理*.ui文件.load(...)方法从D串加载ui文件.输出是表单中按主部件嵌入的QtE5QWidget.标准应用如下:
class QtE56Help: QMainWindow {
...
QFormBuilder qfb;
QAction acAboutQt, knNabor ...
QPushButton knNabor;
...
this() {
super(null);
qfb = new QFormBuilder(this); // (1)
//在主部件表单上从QDesigner设置QWidget
setQtObj((qfb.load(":/fQtE56help.ui")).QtObj); // (2)
//查找地址元素并保存在QtE56类中.
// (3)
acAboutQt = new QAction('+', qfb.findChildAdr!string("actionAboutQt"), this, &onAbout, aThis, 2);
acAboutApp = new QAction('+', qfb.findChildAdr!string("actionAboutApp"), this, &onAbout, aThis, 1);
knNabor = new QPushButton('+', qfb.findChildAdr!string("pushButton_Nabor"));
// 等等...
...
}
...
}该例中,可看到要点:
(1标签)创建QFormBuilder实例.
(2标签)加载ui文件按主表单组件锚定结果组件.
(3标签)找并链接表单元素和QtE56类.
从上例可知如何处理*.ui文件.可同样用qrc文件.为此,需要编译它们得到二进制形式.如下为Qt资源编译器编译资源文件至输出二进制.*.qrc资源文件可从QDesigner取(见Qt文档).从QDesigner编译a3.qrc:
$ rcc -binary a3.qrc -o a3.rcc预处理后,得到可包含ui文件中文本等的二进制文件.还需定义处理(QResource)资源类,并用它在应用中注册资源.注意,资源是之前用D导入字节数组加载的.
示例:
ubyte* gResource = cast(ubyte*)import("a3.rcc");
...
QResource qrs = new QResource(); qrs.registerResource(gResource);现在setQtObj((qfb.load(":/fQtE56help.ui")).QtObj;),访问元素,:帮助见qt文档.
结论.
本文简短介绍了QtE56工作原理.我在Windows,Linux和MacOs上的32/64项目中用了该库.有了它,我使用了:D,C++,Forth,tclsh同Qt对接.
致谢.
我要向优秀的D编程语言作者:WalterBright,表示衷心感谢.自从我开始用他的ZortechC++学习C++编程以来,每天用D写代码,对我来说是双倍愉快.
