技术标签: qml c++ qt Qt MOOC系列教程 gui 软件开发
到目前为止,我们已经讨论了如何将对象实例公开给QML上下文。有时我们还希望在QML中可以使用注册类本身。注册允许将类当作QML中的数据类型来使用。此外,注册还可以提供其他功能,比如允许在QML中将类用作可实例化的QML对象类型,或者允许在QML中导入和使用类的单例实例。
通常我们使用Q_OBJECT
宏注册从QObject
派生的类,也可以用Q_GADGET
宏声明一个比QObject
“更轻”的版本。在这些更轻的类中,我们可以访问它们的属性、枚举和可调用的方法,但不能使用信号槽系统,我们稍后会进行介绍。
要将QObject
派生的类注册为可实例化的QML对象类型,请调用qmlRegisterType()
将类作为QML类型注册到特定的类型名称空间中。然后,客户端可以导入该名称空间以使用该类型。
假设有一个带有author
和creationDate
属性的Message
类:
class Message : public QObject
{
Q_OBJECT
Q_PROPERTY(QString author READ author WRITE setAuthor NOTIFY authorChanged)
Q_PROPERTY(QDateTime creationDate READ creationDate WRITE setCreationDate NOTIFY creationDateChanged)
public:
// ...
};
可以通过使用合适的类型名称空间和版本号调用qmlRegisterType()
来注册此类型。比如使该类型在com.mycompany.messaging
版本1.0的名称空间中可用:
qmlRegisterType<Message>("com.mycompany.messaging", 1, 0, "Message");
然后在QML的对象声明中可以使用该类型,并且可以按以下示例读取和写入其属性:
import com.mycompany.messaging 1.0
Message {
author: "Amelie"
creationDate: new Date()
}
有时,可能需要向QML类型系统注册QObject
派生类时不希望将其注册为可实例化类型。比如一个C++类:
Qt QML模块提供了几种注册非实例化类型的方法:
qmlRegisterType()
(不带参数)注册一个不可实例化且无法从QML引用的C++类型。这使引擎能够强制执行可从QML实例化的所有继承类型。qmlRegisterInterface()
使用特定的QML类型名称注册Qt的接口类型。类型不能从QML实例化,但可以通过其类型名引用。qmlRegisterUncreatableType()
注册一个C++类型,该类型不可实例化,但应可识别为QML类型系统的类型。如果类型的枚举或附加属性应该可以从QML访问,但是类型本身不应该是可实例化的,那么这很有用。qmlRegisterSingletonType()
注册可以从QML导入的单例类型。下面我们讨论一下单例类型。
QObject
单例类型可以与任何其他QObject
或实例化类型进行交互,但只有一个实例存在,而且必须通过类型名称而不是id进行引用。QObject
单例类型的Q_PROPERTY
可以用于属性绑定,QObject
模块API的Q_INVOKABLE
函数可以用于信号处理器表达式。这使得单例类型成为实现样式化或主题化的理想方式。
假设我们有一个用于主题的单例类型,它已注册到MyThemeModule
1.0版本的名称空间中,其中QObject
具有一个QColor color
属性。然后我们可以简单地使用它:
import MyThemeModule 1.0 as Theme
Rectangle {
color: Theme.color // binding.
}
另一个例子是我们有一个只用于枚举的类。请注意,在这种情况下,我们可以使用前面提到的更轻量级的Q_GADGET
宏(因为我们不需要信号和槽):
// modeclass.h
#include <QObject>
class ModeClass
{
Q_GADGET
public:
explicit ModeClass();
enum Mode { Slow, Normal, Fast, UsainBolt };
Q_ENUM(Mode)
};
注册:
qmlRegisterUncreatableType<ModeClass>("com.mycompany.modes", 1, 0, "ModeClass", "Message");
让我们通过一个例子来看看如何创建一个自定义的QObject
派生类然后在QML中使用:
// cppperson.h
class CppPerson : public QObject
{
Q_OBJECT
Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
Q_PROPERTY(int shoeSize READ shoeSize WRITE setShoeSize NOTIFY shoeSizeChanged)
public:
CppPerson(QObject *parent = nullptr);
QString name() const;
void setName(const QString &name);
int shoeSize() const;
void setShoeSize(int size);
signals:
void nameChanged();
void shoeSizeChanged();
private:
QString m_name;
int m_shoeSize;
};
// cppperson.cpp
#include "cppperson.h"
CppPerson::CppPerson(QObject *parent) :
QObject(parent), m_shoeSize(0)
{
}
QString CppPerson::name() const
{
return m_name;
}
void CppPerson::setName(const QString &name)
{
if (m_name != name) {
m_name = name;
emit nameChanged();
}
}
int CppPerson::shoeSize() const
{
return m_shoeSize;
}
void CppPerson::setShoeSize(int size)
{
if (m_shoeSize != size) {
m_shoeSize = size;
emit shoeSizeChanged();
}
}
// main.cpp
...
qmlRegisterType<CppPerson>("People", 1,0, "Person");
...
// main.qml
import QtQuick 2.9
import QtQuick.Window 2.3
import People 1.0
Window {
width: 640; height: 480
visible: true
Rectangle {
anchors.fill: parent
// Person is implemented in C++
Person {
id: person
name: "Bob Jones"
shoeSize: 12
onNameChanged: {
console.log("New name: " + name)
}
onShoeSizeChanged: {
console.log("New shoe size: " + shoeSize)
}
}
Column {
anchors.fill: parent
spacing: 20
Text {
font.bold: true
font.pixelSize: 26
text: "Person name: " + person.name
}
Text {
font.bold: true
font.pixelSize: 26
text: "Person shoe size: " + person.shoeSize
}
}
MouseArea {
anchors.fill: parent
onClicked: {
person.name = "John Doe"
person.shoeSize = 9
}
}
}
}
C++端现在应该开始变得熟悉,我们使用Q_PROPERTY
在头文件中声明了属性及其访问器和信号,并在cppperson.cpp
文件中实现了getter和setter。(不要忘记在setter中发出xxxChanged
信号!)
我们在QML里导入已注册的类型,然后就可以像使用其他QML类型一样使用它。属性绑定与通常一样是按名称进行的,信号的槽自动存在,遵循命名约定onXxxChanged
。
一个常见的需求是在C++中实现一个模型来存储数据,然后在QML中显示。更专业的用例通常要求我们编写自己的模型,例如在下一节中,我们将通过子类化QAbstractTableModel
(继承自QAbstractItemModel
)来实现我们自己的表格模型。Qt还提供了一个简单的通用模型来存储自定义数据,称为QStandardItemModel
。
// mymodel.h
#include <QStandardItemModel>
class MyModel : public QStandardItemModel
{
Q_OBJECT
public:
enum Roles {
BrandRole = Qt::UserRole + 1,
ModelRole
};
explicit MyModel(QObject *parent = nullptr);
QHash<int, QByteArray> roleNames() const Q_DECL_OVERRIDE;
Q_INVOKABLE void addCar(const QString &brand, const QString &model);
};
// mymodel.cpp
#include "mymodel.h"
MyModel::MyModel(QObject *parent) : QStandardItemModel(parent)
{
}
QHash<int, QByteArray> MyModel::roleNames() const
{
QHash<int, QByteArray> mapping = QStandardItemModel::roleNames();
mapping[BrandRole] = "brand";
mapping[ModelRole] = "model";
return mapping;
}
void MyModel::addCar(const QString &brand, const QString &model)
{
QStandardItem *item = new QStandardItem;
item->setData(brand, BrandRole);
item->setData(model, ModelRole);
appendRow(item);
}
这里要注意的最重要部分是重写的roleNames()
函数,其中指定的角色被映射到数字(枚举)。这使得我们能够使用名称“brand”和“model”来引用QML中的数据。
另外,不要忘记用Q_INVOKABLE
声明addCar
方法,以允许它可以在QML中使用。
// main.cpp
qmlRegisterType<MyModel>("org.mooc.cars", 1, 0, "MyModel");
// main.qml
import QtQuick 2.9
import QtQuick.Window 2.2
import org.mooc.cars 1.0
Window {
visible: true
width: 640
height: 480
title: qsTr("Cars")
MyModel {
id: cars
}
ListView {
anchors.fill: parent
model: cars
delegate: Text {
text: "The brand is " + brand + " and the model is " + model
}
}
// Some way to populate the model, cars.addCar("brand", "model")
...
}
导入自定义QML组件时,它会首先加载到内存中。为了缩短启动时间,您可以将组件改为插件,在这种情况下,一旦创建了对象,它就会被动态加载。
要编写QML扩展插件,我们需要:
QQmlExtensionPlugin
qmldir
文件描述此插件假设我们有一个C++类TimeModel
,需要将其作为新的QML类型使用。它提供当前时间hour
和minute
属性。
class TimeModel : public QObject
{
Q_OBJECT
Q_PROPERTY(int hour READ hour NOTIFY timeChanged)
Q_PROPERTY(int minute READ minute NOTIFY timeChanged)
...
现在,我们创建一个名为QExampleQmlPlugin
的类,它继承至QmlExtensionPlugin
:
class QExampleQmlPlugin : public QQmlExtensionPlugin
{
Q_OBJECT
Q_PLUGIN_METADATA(IID QQmlExtensionInterface_iid)
public:
void registerTypes(const char *uri) override
{
Q_ASSERT(uri == QLatin1String("TimeExample"));
qmlRegisterType<TimeModel>(uri, 1, 0, "Time");
}
};
Q_PLUGIN_METADATA()
宏将插件注册到具有唯一标识符的元对象系统。registerTypes()
方法,用qmlRegisterType
注册TimeModel
类型。Q_ASSERT
不是必须的,但是我们可以使用它来确保使用此插件的任何QML组件都能正确导入类型名称空间。接下来,我们需要一个.pro
项目文件:
TEMPLATE = lib
CONFIG += qt plugin
QT += qml
DESTDIR = imports/TimeExample
TARGET = qmlqtimeexampleplugin
SOURCES += qexampleqmlplugin.cpp
它将项目定义为插件库,指定构建目录,并注册插件目标名称。
最后,我们需要一个qmldir
文件来描述插件:
module TimeExample
plugin qmlqtimeexampleplugin
获取更多信息,请关注作者公众号:程序员练兵场
文章浏览阅读1.1w次,点赞7次,收藏34次。vue-grid-layout的使用、实例、遇到的问题和解决方案_vue-grid-layout
文章浏览阅读218次。然后连接一个数据源,就会在下面自动产生一个添加附件的组件。把这个控件复制粘贴到页面里,就可以单独使用来上传了。插入一个“编辑”窗体。_powerapps点击按钮上传附件
文章浏览阅读264次。(1) Abstraction (抽象)(2) Polymorphism (多态)(3) Inheritance (继承)(4) Encapsulation (封装)_"object(cnofd[\"ofdrender\"])十条"
文章浏览阅读133次。删除node_modules,重新npm install看是否成功。在 package.json 文件中的 scripts 中加入。修改你的第三方库的bug等。然后目录会多出一个目录文件。_修改 node_modules
文章浏览阅读883次。【代码】【】kali--password:su的 Authentication failure问题,&sudo passwd root输入密码时Sorry, try again._password: su: authentication failure
文章浏览阅读1w次,点赞13次,收藏97次。整理5个优秀的微信小程序开源项目。收集了微信小程序开发过程中会使用到的资料、问题以及第三方组件库。_微信小程序开源模板
文章浏览阅读128次。Centos7最简搭建NFS服务器_centos7 搭建nfs server
文章浏览阅读1.2k次,点赞2次,收藏3次。前言mybatis在持久层框架中还是比较火的,一般项目都是基于ssm。虽然mybatis可以直接在xml中通过SQL语句操作数据库,很是灵活。但正其操作都要通过SQL语句进行,就必须写大量的xml文件,很是麻烦。mybatis-plus就很好的解决了这个问题。..._mybaitis-plus ruledataobjectattributemapper' and 'com.picc.rule.management.d
文章浏览阅读325次。EECE 1080C / Programming for ECESummer 2022Laboratory 4: Global Functions PracticePlagiarism will not be tolerated:Topics covered:function creation and call statements (emphasis on global functions)Objective:To practice program development b_eece1080c
文章浏览阅读53次。被同机房早就1年前就学过的东西我现在才学,wtcl。设要求的数为\(x\)。设当前处理到第\(k\)个同余式,设\(M = LCM ^ {k - 1} _ {i - 1}\) ,前\(k - 1\)个的通解就是\(x + i * M\)。那么其实第\(k\)个来说,其实就是求一个\(y\)使得\(x + y * M ≡ a_k(mod b_k)\)转化一下就是\(y * M ...
文章浏览阅读1.3k次。首先,问题是如何出现的?晚上复查代码,发现一个activity没有调用自己的ondestroy方法我表示非常的费解,于是我检查了下代码。发现再finish代码之后接了如下代码finish();System.exit(0);//这就是罪魁祸首为什么这样写会出现问题System.exit(0);////看一下函数的原型public static void exit (int code)//Added ..._android 手动杀死app,activity不执行ondestroy
文章浏览阅读894次。Q: SylixOS 版权是什么形式, 是否分为<开发版税>和<运行时版税>.A: SylixOS 是开源并免费的操作系统, 支持 BSD/GPL 协议(GPL 版本暂未确定). 没有任何的运行时版税. 您可以用她来做任何 您喜欢做的项目. 也可以修改 SylixOS 的源代码, 不需要支付任何费用. 当然笔者希望您可以将使用 SylixOS 开发的项目 (不需要开源)或对 SylixOS 源码的修改及时告知笔者.需要指出: SylixOS 本身仅是笔者用来提升自己水平而开发的_select函数 导致堆栈溢出 sylixos