Qt Quick 教程(二)

文章目录

今天分析一段代码

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

相关推荐
Black_Friend9 分钟前
关于在VS中使用Qt不同版本报错的问题
开发语言·qt
CSUC17 分钟前
【Qt】QTreeView 和 QStandardItemModel的关系
qt
冷凝女子1 小时前
【QT】海康视频及openCv抓拍正脸接口
qt·opencv·音视频·海康
苏三有春3 小时前
PyQt5实战——UTF-8编码器功能的实现(六)
开发语言·qt
Vanranrr4 小时前
C++ QT
java·c++·qt
兆。4 小时前
掌握 PyQt5:从零开始的桌面应用开发
开发语言·爬虫·python·qt
徒步僧15 小时前
ThingsBoard规则链节点:RPC Call Reply节点详解
qt·microsoft·rpc
可峰科技16 小时前
斗破QT编程入门系列之一:认识Qt:初步使用(四星斗师)
开发语言·qt
我喜欢就喜欢16 小时前
基于qt vs下的视频播放
开发语言·qt·音视频
CP-DD17 小时前
Qt的架构设计
qt