Incrustar QML (QmlBridge)
QmlView Vista QML
Superficie QML que comparte modelos de aplicación y tokens de tema Fluent con los Widgets circundantes.
Ejemplo
No se pudo cargar la vista previa de propiedades. Selecciona Vista previa de propiedades para reintentar.

Uso
Cargar una página QML
Activa una QmlSession, crea una QmlView con QmlSession::createView() y carga una URL QML. Al compartir ventana con vistas OpenGL, selecciona el backend gráfico de Quick antes de crear la primera vista 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
DeclaraciónNo hay miembros de la API que coincidan.
fluent::qmlbridge::QmlView
Hereda de QWidget · FluentElement · QMLPlus
Contenedor QWidget para incrustar y mostrar una página QML de aplicación. Asócialo a una QmlSession activa antes de usarlo; carga solo QML de confianza (las escenas se descargan automáticamente al desactivar la sesión).
Constructores
Destructores
Enumeraciones
enum StatusUnloadedLoadingReadyError
Métodos
QObject* rootObject() constDevuelve el objeto raíz QML cargado, o nullptr hasta que esté listo o después de unload().
QObject* themeObject() constDevuelve el objeto de contexto fluentTheme gestionado por la vista.
bool setContextObject(const QString& name, QObject* object)Registra un QObject del hilo de la GUI bajo name antes de cargar (pasa nullptr para quitarlo; "fluentTheme" está reservado). El llamador conserva el ciclo de vida del objeto; los enlaces persisten tras unload() y destruir un objeto enlazado descarga la escena.
bool load(const QUrl& source, QString* error = nullptr)Carga una URL de QML absoluta; devuelve true cuando está lista o cuando comienza la carga asíncrona. Observe statusChanged() y errorOccurred() para errores asíncronos; llame primero a unload() para volver a cargar la misma URL.
void unload()Descarga la escena QML y restablece el estado manteniendo intactos los enlaces de contexto externos. Es seguro llamarlo desde callbacks de QML (el desmontaje se difiere hasta que los callbacks finalicen).
bool setTextureRenderingEnabled(bool enabled)Alterna el renderizado de texturas OpenGL fuera de pantalla sin recargar la escena QML. Cuando está habilitado, el llamador debe invocar renderTexture() y dibujar la textura; puede establecerse antes de load().
bool isTextureRenderingEnabled() constIndica si está habilitado el renderizado de texturas fuera de pantalla.
bool renderTexture(QOpenGLContext* context, qreal devicePixelRatio, quint64 maximumBytes = 67108864)Renderiza la escena QML en una textura usando el contexto OpenGL actual del llamador (solo en el hilo de la GUI). devicePixelRatio debe estar en (0, 4]; maximumBytes limita los búferes de color y profundidad.
unsigned int textureId() constDevuelve la textura OpenGL RGBA premultiplicada (origen inferior izquierdo), o 0 si no está disponible. Se invalida tras releaseTexture(), unload(), cambio de tamaño o cambio de contexto.
QSize textureSize() constDimensiones de la textura en píxeles de dispositivo.
quint64 textureRevision() constContador de revisión de fotogramas que se incrementa en cada fotograma renderizado.
QVariantMap textureStatistics() constMapa de diagnóstico con uso de memoria de texturas, recuento de fotogramas y último error.
void releaseTexture()Libera los destinos de renderizado de GPU manteniendo intactos la escena QML y el ajuste de modo de textura.
Propiedades
QUrl source- Lectura
source()NotificaciónsourceChanged() Status status- Lectura
status()NotificaciónstatusChanged() bool active- Lectura
isActive()NotificaciónactiveChanged() QStringList errors- Lectura
errors()NotificaciónerrorsChanged() QString lastError- Lectura
lastError()NotificaciónerrorsChanged() QObject* themeDevuelve el objeto de contexto fluentTheme gestionado por la vista.
LecturathemeObject()bool textureRenderingEnabledIndica si está habilitado el renderizado de texturas fuera de pantalla.
LecturaisTextureRenderingEnabled()EscriturasetTextureRenderingEnabled()NotificacióntextureRenderingEnabledChanged()
Señales
void textureRenderingEnabledChanged(bool enabled)Indica si está habilitado el renderizado de texturas fuera de pantalla.
Miembros protegidos
Métodos
Heredado de fluent::FluentElement
Enumeraciones
enum ThemeTema visual global usado al resolver los tokens de diseño.
Light = 0Dark = 1HighContrast = 2
Métodos
static void setTheme(Theme theme)Actualiza el tema global y notifica a las instancias activas de FluentElement.
static void setThemeDeferred(Theme theme)Programa una actualización de tema por lotes dando prioridad a lo visible sin bloquear la interacción actual.
static Theme currentTheme()Devuelve el tema global activo actualmente.
static bool themeUsesDarkAppearance(Theme theme)Devuelve si un tema utiliza cromo sobre fondo oscuro y tokens de material.
static void refreshTheme()Vuelve a difundir el tema actual para repintar tras un cambio de token de diseño.
static int themeGeneration()Contador monótono incrementado en cada cambio de tema para comprobaciones de obsolescencia.
Theme effectiveTheme() constResuelve el tema usado por este elemento, respetando una invalidación heredada de QWidget.
bool effectiveThemeUsesDarkAppearance() constDevuelve si el tema efectivo de este elemento usa cromo sobre fondo oscuro.
bool setThemeOverrides(const QJsonObject& overrides)Reemplaza las invalidaciones dispersas de tokens de color, radio y fuente de este elemento.
QJsonObject themeOverrides() constDevuelve las anulaciones definidas en este elemento.
void clearThemeOverrides()Restaura todos los campos de token a los valores predeterminados del tema global.
const Colors& themeColorsRef() constAcceso sin copia al conjunto de colores activo para rutas críticas de pintado.
Material::AcrylicToken themeAcrylic() constTokens de material, elevación y diseño adaptable.
QColor themeBackdrop(bool active) constColor de fondo del chrome de la ventana para el estado de activación indicado.
virtual void onThemeUpdated()Se llama después de que cambia el tema global.
Tipos y alias
struct ColorsInstantáneas de tokens de diseño devueltas a los componentes.
Heredado de fluent::QMLPlus
Métodos
AnchorLayout::Anchors* anchors()Devuelve los anclajes mutables del host QWidget.
void setState(const QString& name)Aplica un estado registrado por nombre o restaura el estado predeterminado cuando @p name está vacío. Los nombres desconocidos se ignoran y los enlaces existentes se reanudan al salir del estado.
void addState(const QMLState& state)Registra o reemplaza una definición de estado con nombre; reemplazar el estado activo lo aplica de inmediato.
void evaluateStates()Reevalúa las condiciones de estado en orden de registro y activa la primera coincidencia, o el estado predeterminado si ninguna coincide. También se ejecuta automáticamente cuando notifican las propiedades dependientes; los estados derivados que usan extend heredan cambios de ancestros salvo que sean cíclicos o falten.
QMLPlusRuntime* runtime()Devuelve el observador de estado creado de forma diferida y propiedad de este host.
void setAnchors(const AnchorLayout::Anchors& anchors)Reemplaza todos los anclajes del host e invalida el diseño padre.
void resetAnchors()Limpia todos los anclajes del host e invalida el diseño padre.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Vincula @p sourceProp en @p source con @p targetProp en este host QWidget mediante PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Instala un enlace directo gestionado en este host QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Instala una expresión C++ de dependencias explícitas en este host QWidget.
void addTransition(const StateTransition& transition)Registra una transición de estado por orden de precedencia.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Establece la animación por defecto usada al escribir @p propertyName mediante writeProperty() o un enlace. Las reglas StateTransition explícitas tienen prioridad; las llamadas directas a setters de C++ no se animan.
void clearBehavior(const char* propertyName)Quita la animación predeterminada para futuras escrituras administradas.
bool writeProperty(const char* propertyName, const QVariant& value)Escribe una propiedad del host mediante Behavior sin eliminar su enlace.
Documentación de la clase base de Qt: QWidget