Встраивание QML (QmlBridge)
QmlView QML-представление
Область QML, разделяющая модели приложения и токены темы Fluent с окружающими Widgets.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Загрузка 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();
}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
ОбъявлениеНет подходящих элементов API.
fluent::qmlbridge::QmlView
Наследует QWidget · FluentElement · QMLPlus
Контейнер QWidget для встраивания и отображения страницы QML приложения. Перед использованием привяжите к активной QmlSession; загружайте только доверенный QML (сцены автоматически выгружаются при деактивации сессии).
Конструкторы
Деструкторы
Перечисления
enum StatusUnloadedLoadingReadyError
Методы
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 = 0Dark = 1HighContrast = 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 bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Устанавливает управляемую прямую привязку на этом хосте QWidget.
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