Fluent-Qt

Встраивание QML (QmlBridge)

QmlView QML-представление

Область QML, разделяющая модели приложения и токены темы Fluent с окружающими Widgets.

Пример

QmlView QML-представление: Загрузка QML-страницы

Использование

Загрузка QML-страницы

Активируйте QmlSession, создайте QmlView с помощью QmlSession::createView() и загрузите QML URL. При совместном использовании окна с представлениями OpenGL выберите графический бэкенд Quick до создания первого представления Quick.

#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();
}

fluent::qmlbridge::QmlView

Наследует QWidget · FluentElement · QMLPlus

Контейнер QWidget для встраивания и отображения страницы QML приложения. Перед использованием привяжите к активной QmlSession; загружайте только доверенный QML (сцены автоматически выгружаются при деактивации сессии).

Конструкторы

Деструкторы

Перечисления

enum Status
  • Unloaded
  • Loading
  • Ready
  • Error

Методы

QObject* rootObject() const

Возвращает загруженный корневой объект QML или nullptr до готовности и после unload().

QObject* themeObject() const

Возвращает контекстный объект fluentTheme, принадлежащий представлению.

bool setContextObject(const QString& name, QObject* object)

Регистрирует QObject потока GUI под именем name перед загрузкой (передайте nullptr для удаления; "fluentTheme" зарезервировано). Время жизни объекта остаётся за вызывающей стороной; привязки сохраняются после unload(), а уничтожение привязанного объекта выгружает сцену.

bool load(const QUrl& source, QString* error = nullptr)

Загружает абсолютный QML URL; возвращает true при готовности или запуске асинхронной загрузки. Отслеживайте statusChanged() и errorOccurred() для асинхронных ошибок; для повторной загрузки того же URL сначала вызовите unload().

void unload()

Выгружает сцену QML и сбрасывает состояние, сохраняя внешние привязки контекста. Безопасно вызывать из обратных вызовов QML (очистка откладывается до их завершения).

bool setTextureRenderingEnabled(bool enabled)

Переключает внеэкранный рендеринг в текстуру OpenGL без перезагрузки сцены QML. При включении вызывающая сторона должна вызывать renderTexture() и отрисовывать текстуру; можно задать до load().

bool isTextureRenderingEnabled() const

Включён ли внеэкранный рендеринг в текстуру.

bool renderTexture(QOpenGLContext* context, qreal devicePixelRatio, quint64 maximumBytes = 67108864)

Рендерит сцену QML в текстуру в текущем контексте OpenGL вызывающего кода (только поток GUI). Значение devicePixelRatio должно быть в (0, 4]; maximumBytes ограничивает буферы цвета/глубины.

unsigned int textureId() const

Возвращает текстуру OpenGL RGBA с предумноженной альфой (начало координат в левом нижнем углу) или 0, если она недоступна. Становится недействительной при releaseTexture(), unload(), изменении размера или смене контекста.

QSize textureSize() const

Размеры текстуры в пикселях устройства.

quint64 textureRevision() const

Счётчик ревизии кадра, увеличиваемый на каждом отрисованном кадре.

QVariantMap textureStatistics() const

Карта диагностики с использованием памяти текстур, счётчиком кадров и последней ошибкой.

void releaseTexture()

Освобождает цели рендеринга GPU, сохраняя сцену QML и настройку режима текстур.

Свойства

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()

Сигналы

void textureRenderingEnabledChanged(bool enabled)

Включён ли внеэкранный рендеринг в текстуру.

Защищённые члены

Методы

Унаследовано от fluent::FluentElement

Перечисления

enum Theme

Глобальная визуальная тема, используемая при разрешении дизайн-токенов.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Методы

static void setTheme(Theme theme)

Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.

static void setThemeDeferred(Theme theme)

Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.

static Theme currentTheme()

Возвращает текущую активную глобальную тему.

static bool themeUsesDarkAppearance(Theme theme)

Возвращает, использует ли тема токены тёмного оформления и материалов.

static void refreshTheme()

Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.

static int themeGeneration()

Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.

Theme effectiveTheme() const

Определяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.

bool effectiveThemeUsesDarkAppearance() const

Возвращает, использует ли действующая тема этого элемента тёмную основу оформления.

bool setThemeOverrides(const QJsonObject& overrides)

Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.

QJsonObject themeOverrides() const

Возвращает заданные переопределения этого элемента.

void clearThemeOverrides()

Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.

const Colors& themeColorsRef() const

Доступ без копирования к активному набору цветов для горячих путей отрисовки.

Material::AcrylicToken themeAcrylic() const

Токены материалов, возвышения и адаптивной компоновки.

QColor themeBackdrop(bool active) const

Цвет фона рамки окна для заданного состояния активации.

virtual void onThemeUpdated()

Вызывается после изменения глобальной темы.

Типы и псевдонимы

struct Colors

Снимки дизайн-токенов, возвращаемые компонентам.

Унаследовано от fluent::QMLPlus

Методы

AnchorLayout::Anchors* anchors()

Возвращает изменяемые привязки для хоста QWidget.

void setState(const QString& name)

Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.

void addState(const QMLState& state)

Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.

void evaluateStates()

Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.

QMLPlusRuntime* runtime()

Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.

void setAnchors(const AnchorLayout::Anchors& anchors)

Заменяет все привязки хоста и инвалидирует родительскую компоновку.

void resetAnchors()

Очищает все привязки хоста и делает родительский макет недействительным.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().

BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})

Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.

void addTransition(const StateTransition& transition)

Регистрирует переход состояния в порядке приоритета.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.

void clearBehavior(const char* propertyName)

Удаляет анимацию по умолчанию для последующих управляемых записей.

bool writeProperty(const char* propertyName, const QVariant& value)

Записывает свойство хоста через Behavior без удаления его привязки.

Документация базового класса Qt: QWidget