Qt Quick 教程（二）

music score2024-06-21 13:02

文章目录

今天分析一段代码

cpp 复制代码 
    // Register types
    qmlRegisterSingletonType(QUrl("qrc:/StyleSheet.qml"), "Librum.style", 1, 0, "Style");
    qmlRegisterSingletonType(QUrl("qrc:/IconSheet.qml"), "Librum.icons", 1, 0, "Icons");
    qmlRegisterSingletonType(QUrl("qrc:/FontSheet.qml"), "Librum.fonts", 1, 0, "Fonts");
    qmlRegisterSingletonType(QUrl("qrc:/Globals.qml"), "Librum.globals", 1, 0, "Globals");
    qmlRegisterSingletonType(QUrl("qrc:/GlobalSettings.qml"), "Librum.globalSettings", 1, 0, "GlobalSettings");
    qmlRegisterSingletonType(QUrl("qrc:/TranslationsModel.qml"), "Librum.models", 1, 0, "TranslationsModel");
    qmlRegisterSingletonType(QUrl("qrc:/modules/CustomComponents/MLanguageModel.qml"), "Librum.models", 1, 0, "MLanguageModel");
    qmlRegisterType<adapters::data_models::LibraryProxyModel>("Librum.models", 1, 0, "LibraryProxyModel");
    qmlRegisterType<adapters::data_models::BookTitleProxyModel>("Librum.models", 1, 0, "BookTitleModel");
    qmlRegisterType<adapters::data_models::FreeBooksModel>("Librum.models", 1, 0, "FreeBooksModel");
    qmlRegisterType<adapters::data_models::ShortcutsProxyModel>("Librum.models", 1, 0, "ShortcutsProxyModel");
    qmlRegisterType<cpp_elements::KeySequenceRecorder>("Librum.elements", 1, 0, "KeySequenceRecorder");
    qmlRegisterType<cpp_elements::PageView>("Librum.elements", 1, 0, "PageView");
    qRegisterMetaType<adapters::dtos::BookDto>();
    qRegisterMetaType<adapters::dtos::TagDto>();
    qRegisterMetaType<adapters::dtos::FolderDto>();
    qRegisterMetaType<adapters::dtos::DictionaryEntryDto>();
    qRegisterMetaType<adapters::dtos::WordTypeDto>();
    qRegisterMetaType<adapters::dtos::WordDefinitionDto>();

1. 注册单例类型

  • qmlRegisterSingletonType<>() 是一个 C++ 函数模板，用于在 Qt Quick 中注册单例类型，使得在 QML 中可以直接访问和使用这些单例对象。

  • 使用 qmlRegisterSingletonType<>() 可以将一个 C++ 类注册为单例类型，这意味着在整个 QML 应用程序中，只会创建一个该类的实例，并且该实例可以在 QML 中全局访问。这使得在 QML 中可以方便地使用单例对象，无需显式创建实例，而是通过直接引用单例类型来使用它。

  • 这些代码将QML文件注册为单例类型，使得这些类型可以在QML文件中以单例的形式使用。注册的类型可以通过Librum.style.Style、Librum.icons.Icons等名称在QML中访问。

cpp 复制代码 
qmlRegisterSingletonType(QUrl("qrc:/StyleSheet.qml"), "Librum.style", 1, 0, "Style");
qmlRegisterSingletonType(QUrl("qrc:/IconSheet.qml"), "Librum.icons", 1, 0, "Icons");
qmlRegisterSingletonType(QUrl("qrc:/FontSheet.qml"), "Librum.fonts", 1, 0, "Fonts");
qmlRegisterSingletonType(QUrl("qrc:/Globals.qml"), "Librum.globals", 1, 0, "Globals");
qmlRegisterSingletonType(QUrl("qrc:/GlobalSettings.qml"), "Librum.globalSettings", 1, 0, "GlobalSettings");
qmlRegisterSingletonType(QUrl("qrc:/TranslationsModel.qml"), "Librum.models", 1, 0, "TranslationsModel");
qmlRegisterSingletonType(QUrl("qrc:/modules/CustomComponents/MLanguageModel.qml"), "Librum.models", 1, 0, "MLanguageModel");
  • 用法一(C++代码)：
cpp 复制代码 
 // First, define the singleton type provider function (callback).
 static QJSValue example_qjsvalue_singletontype_provider(QQmlEngine *engine, QJSEngine *scriptEngine)
 {
     Q_UNUSED(engine)

     static int seedValue = 5;
     QJSValue example = scriptEngine->newObject();
     example.setProperty("someProperty", seedValue++);
     return example;
 }

 // Second, register the singleton type provider with QML by calling this function in an initialization function.
 qmlRegisterSingletonType("Qt.example.qjsvalueApi", 1, 0, "MyApi", example_qjsvalue_singletontype_provider);
  • 用法二，同理，可以使用C++11 lambda：
cpp 复制代码 
 qmlRegisterSingletonType("Qt.example.qjsvalueApi", 1, 0, "MyApi", [](QQmlEngine *engine, QJSEngine *scriptEngine) -> QJSValue {
     Q_UNUSED(engine)

     static int seedValue = 5;
     QJSValue example = scriptEngine->newObject();
     example.setProperty("someProperty", seedValue++);
     return example;
 });
  • QML中，导入
sh 复制代码 
 import QtQuick 2.0
 import Qt.example.qjsvalueApi 1.0 as ExampleApi
 Item {
     id: root
     property int someValue: ExampleApi.MyApi.someProperty
 }

2. 注册普通QML类型

这些代码将C++类注册为QML类型，使得这些类型可以在QML文件中使用。例如，LibraryProxyModel可以通过Librum.models.LibraryProxyModel在QML中实例化。

cpp 复制代码 
qmlRegisterType<adapters::data_models::LibraryProxyModel>("Librum.models", 1, 0, "LibraryProxyModel");
qmlRegisterType<adapters::data_models::BookTitleProxyModel>("Librum.models", 1, 0, "BookTitleModel");
qmlRegisterType<adapters::data_models::FreeBooksModel>("Librum.models", 1, 0, "FreeBooksModel");
qmlRegisterType<adapters::data_models::ShortcutsProxyModel>("Librum.models", 1, 0, "ShortcutsProxyModel");
qmlRegisterType<cpp_elements::KeySequenceRecorder>("Librum.elements", 1, 0, "KeySequenceRecorder");
qmlRegisterType<cpp_elements::PageView>("Librum.elements", 1, 0, "PageView");

3. 注册C++类型到Qt元对象系统

这些代码将C++类型注册到Qt元对象系统中，使得这些类型可以在信号槽机制中使用。这对于在C++和QML之间传递这些类型的对象是必要的。

cpp 复制代码 
qRegisterMetaType<adapters::dtos::BookDto>();
qRegisterMetaType<adapters::dtos::TagDto>();
qRegisterMetaType<adapters::dtos::FolderDto>();
qRegisterMetaType<adapters::dtos::DictionaryEntryDto>();
qRegisterMetaType<adapters::dtos::WordTypeDto>();
qRegisterMetaType<adapters::dtos::WordDefinitionDto>();

4.总结，具体解释

  • qmlRegisterSingletonType：注册一个QML文件作为单例类型。这个QML文件将在整个应用程序中共享一个实例。例如，qmlRegisterSingletonType(QUrl("qrc:/StyleSheet.qml"), "Librum.style", 1, 0, "Style"); 会注册一个名为Style的单例类型，该类型定义在StyleSheet.qml文件中，并且可以通过Librum.style.Style在QML中访问。

  • qmlRegisterType：将C++类注册为QML类型，使得该类型可以在QML文件中实例化。例如，qmlRegisterType<adapters::data_models::LibraryProxyModel>("Librum.models", 1, 0, "LibraryProxyModel"); 将C++类LibraryProxyModel注册为QML类型LibraryProxyModel，可以通过Librum.models.LibraryProxyModel在QML中使用。

  • qRegisterMetaType：将C++类型注册到Qt的元对象系统中，这对于在信号槽机制中传递这些类型的对象是必要的。例如，qRegisterMetaType<adapters::dtos::BookDto>(); 将BookDto类型注册到Qt的元对象系统中。

5.如何在QML中使用这些注册的类型

使用单例类型

假设在QML中使用Style单例类型：

sh 复制代码 
import QtQuick 2.15
import Librum.style 1.0

Rectangle {
    width: 200
    height: 200

    color: Style.primaryColor
}

使用注册的C++类型:

假设在QML中使用LibraryProxyModel类型：

sh 复制代码 
import QtQuick 2.15
import Librum.models 1.0

ApplicationWindow {
    visible: true
    width: 640
    height: 480

    LibraryProxyModel {
        id: libraryModel
        // 配置模型属性和方法
    }

    ListView {
        model: libraryModel
        // 配置视图属性
    }
}

通过这种方式，你可以在QML文件中利用这些C++类型来构建更复杂的应用程序逻辑和界面。

参考

https://blog.csdn.net/weixin_42208702/article/details/132001997

相关推荐
矛取矛求2 小时前
QT的前景与互联网岗位发展
开发语言·qt
Leventure_轩先生2 小时前
[WASAPI]从Qt MultipleMedia来看WASAPI
开发语言·qt
晓纪同学11 小时前
QT-简单视觉框架代码
开发语言·qt
威桑11 小时前
Qt SizePolicy详解：minimum 与 minimumExpanding 的区别
开发语言·qt·扩张策略
飞飞-躺着更舒服11 小时前
【QT】实现电子飞行显示器（简易版）
开发语言·qt
fyzy11 小时前
Qt获取本地计算的CPU温度
qt
cbdg375711 小时前
Qt 6 QML Settings location 不创建指定路径文件
qt
了一li11 小时前
Qt中的QProcess与Boost.Interprocess：实现多进程编程
服务器·数据库·qt
杨德杰11 小时前
QT网络（一）：主机信息查询
网络·qt
黄金右肾12 小时前
Qt之串口设计-线程实现（十二）
qt·thread·serialport
热门推荐
01【一文读懂】NTN（非地面网络）技术介绍02优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05基于大语言模型（LLM）的合成数据生成、策展和评估的综述06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07组基轨迹建模 GBTM的介绍与实现（Stata 或 R）08HCIA-datacom数通题库和录播视频资料09Docker 夺命连环 15 问10RAG 实践- Ollama+RagFlow 部署本地知识库