QmlBridge：嵌入 QML

QmlView QML 视图

在 Widgets 界面中加载 QML 页面，并共享数据和主题。

示例

用法

加载 QML 页面

先激活 QmlSession，再用 createView() 创建 QmlView 并加载 QML 文件；激活失败时显示错误信息。

#include <FluentQt/QmlBridge.h>
using namespace fluent::qmlbridge;

// main.cpp; build with CMakeLists.txt and keep the QML page in its own file.
#include <FluentQt/FluentQt.h>
#include <FluentQt/QmlBridge.h>
#include <QApplication>
#include <QHBoxLayout>
#include <QVBoxLayout>

using fluent::basicinput::Button;
using fluent::qmlbridge::QmlSession;
using fluent::qmlbridge::QmlView;
using fluent::status_info::ProgressBar;
using fluent::textfields::Label;
using fluent::textfields::LineEdit;
using fluent::windowing::Window;

QWidget* makePanel(const QUrl& source, QWidget* parent)
{
    auto* panel = new QWidget(parent);
    auto* column = new QVBoxLayout(panel);
    column->setContentsMargins(16, 16, 16, 16);
    column->setSpacing(12);
    column->setAlignment(Qt::AlignTop);
    auto* session = new QmlSession(panel, panel);
    QString error;
    QmlView* view = session->activate(&error) ? session->createView(panel) : nullptr;
    if (!view) {
        column->addWidget(new Label(error.isEmpty() ? "QML is unavailable" : error, panel));
        return panel;
    }
    view->setFixedHeight(100);
    column->addWidget(view);
    view->load(source);
    return panel;
}

int main(int argc, char* argv[])
{
    fluent::prepareHighDpiApplication();
    QmlSession::prepareApplication();
    QApplication application(argc, argv);
    fluent::initializeResources();
    application.setFont(Typography::fontStyle(Typography::FontRole::Body).toQFont());

    Window window;
    window.setWindowTitle("QmlView");
    window.resize(640, 480);
    window.setContentWidget(makePanel(QUrl("qrc:/Basic.qml"), &window));
    window.show();
    return application.exec();
}

import fluentqt

from fluentqt.qmlbridge import QmlSession

# main() calls QmlSession.prepareApplication() before QApplication.
# panel and qml_source() are defined in Full example.
session = QmlSession(panel, panel)
view = session.createView(panel) if session.activate() else None
if view is not None:
    view.setFixedHeight(100)
    view.load(qml_source("Basic"))

API

查看声明

`fluent::qmlbridge::QmlView`

继承自 QWidget · FluentElement · QMLPlus

在调用方持有的 QWidget 中承载应用的 QML 页面。

构造函数

explicit QmlView(QWidget* parent = nullptr)

属性

QUrl source: 读取 source()通知 sourceChanged()
Status status: 读取 status()通知 statusChanged()
bool active: 读取 isActive()通知 activeChanged()
QStringList errors: 读取 errors()通知 errorsChanged()
QString lastError: 读取 lastError()通知 errorsChanged()
QObject* theme: 返回视图持有的 fluentTheme 对象。
读取 themeObject()
bool textureRenderingEnabled: 返回请求的纹理呈现模式。
读取 isTextureRenderingEnabled()设置 setTextureRenderingEnabled()通知 textureRenderingEnabledChanged()