확장 모듈
QML 임베딩 (QmlBridge)
앱 테마와 데이터를 공유하면서 Qt Widgets 창 내부에 QML 뷰를 호스팅합니다.
뷰 생성
FluentQt::QmlBridge를 링크하고 QmlSession을 시작한 뒤 QmlView 위젯을 생성합니다. 노출된 모델의 소유권은 앱에 남아 있으며, 비활성화를 호출하면 뷰나 모델을 삭제하지 않고 QML 씬만 언로드합니다.
#include <FluentQt/QmlBridge.h>
// The session manages its own PluginManager; window and models stay caller-owned.
auto* session = new fluent::qmlbridge::QmlSession(window, window);
if (session->activate()) {
auto* qmlView = session->createView(parentWidget);
// Load a QML scene into qmlView.
}from fluentqt.qmlbridge import QmlSession
# The session manages its own PluginManager; window and models stay caller-owned.
session = QmlSession(window, window)
if session.activate():
qml_view = session.createView(parent_widget)OpenGL 호환성 및 테마
Qt Quick이 SpatialView 또는 QOpenGLWidget과 창을 공유한다면 첫 번째 Quick 뷰를 만들기 전에 QmlSession::prepareApplication()을 호출하세요. QML 내부에서는 QmlTheme가 제공하는 읽기 전용 fluentTheme 객체로 테마 색상과 글꼴을 읽을 수 있습니다.