C

使用 Qt QML 重复使用 Qt Quick Ultralite QML 对象

Qt Quick Ultralite 的 Qt QML 兼容模块

Qt Quick Ultralite 提供了兼容性模块,以便您可以使用 Qt Quick Ultralite QML 对象与 Qt QML。这些模块位于 <Qul 安装目录>/compatibility

Qt Quick Ultralite 提供以下兼容性模块

名称最低版本
额外内容1.0
1.7
StudioComponents2.7

注意:每个模块都可以使用当前安装的包的次要版本号导入。

要使用任何模块,必须将 <Qul 安装目录>/compatibility 目录添加到 QML 导入路径,并在 .qml 文件中导入所需模块。

注意:模块需要 Qt 6.2

导入 Qt Quick Ultralite Extras,Qt Quick Ultralite Layers 或 Qt Quick Ultralite Studio Components 模块。

// sample main.cpp file
...

int main(int argc, char *argv[])
{
    ...

    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    engine.addImportPath("<Qul install directory>/compatibility");

    ...

    return app.exec();
}
// sample main.qml file
import QtQuick 2.15
...
import QtQuickUltralite.Extras 2.8.0

Window {
    ...

    StaticText {
        text: "Hello World!"
    }
}

注意:“额外内容”模块使用 C++,因此模块的二进制文件必须与用户的工程配置匹配。

要利用 Qt Creator 的代码完成功能,将 <Qul 安装目录>/compatibility 目录添加到 QML_IMPORT_PATH

构建

Qt Quick Ultralite 源代码包提供了模块的源代码,这些模块位于 QUL_DIR/compatibility/QtQuickUltralite/*。如果提供的二进制文件与您的项目配置不匹配,您可以使用所需的设置构建库。

该包包含一个 CMakeLists.txt 文件,该文件用于构建模块。要构建 Extras 模块,执行 QtQuickUltraliteExtras CMake 目标。默认输出位置设置为 CMake 变量 CMAKE_BINARY_DIR,可以通过设置 CMake 变量 QUL_COMPATIBILITY_MODULE_DIR 进行更改。

要自动化此过程,可以 添加子目录CMakeLists.txt

set(QUL_COMPATIBILITY_DIR ${<Qul install directory>}/compatibility)
add_subdirectory(${QUL_COMPATIBILITY_DIR} ${CMAKE_BINARY_DIR}/compatibility)

然后添加对您的目标的依赖项

add_dependencies(my_target QtQuickUltraliteExtras)

也参见 静态文本彩色图像动画精灵目录QulPerf项目层图像层精灵层应用屏幕屏幕,以及弧形项目

在特定的Qt许可下可用。
了解更多。