Fluent-Qt

Incrustar QML (QmlBridge)

QmlView Vista QML

Superficie QML que comparte modelos de aplicación y tokens de tema Fluent con los Widgets circundantes.

Ejemplo

QmlView Vista QML: Cargar una página QML

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

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 Status
  • Unloaded
  • Loading
  • Ready
  • Error

Métodos

QObject* rootObject() const

Devuelve el objeto raíz QML cargado, o nullptr hasta que esté listo o después de unload().

QObject* themeObject() const

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

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

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

Dimensiones de la textura en píxeles de dispositivo.

quint64 textureRevision() const

Contador de revisión de fotogramas que se incrementa en cada fotograma renderizado.

QVariantMap textureStatistics() const

Mapa 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ón sourceChanged()
Status status
Lectura status()Notificación statusChanged()
bool active
Lectura isActive()Notificación activeChanged()
QStringList errors
Lectura errors()Notificación errorsChanged()
QString lastError
Lectura lastError()Notificación errorsChanged()
QObject* theme

Devuelve el objeto de contexto fluentTheme gestionado por la vista.

Lectura themeObject()
bool textureRenderingEnabled

Indica si está habilitado el renderizado de texturas fuera de pantalla.

Lectura isTextureRenderingEnabled()Escritura setTextureRenderingEnabled()Notificación textureRenderingEnabledChanged()

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 Theme

Tema visual global usado al resolver los tokens de diseño.

  • Light = 0
  • Dark = 1
  • HighContrast = 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() const

Resuelve el tema usado por este elemento, respetando una invalidación heredada de QWidget.

bool effectiveThemeUsesDarkAppearance() const

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

Devuelve las anulaciones definidas en este elemento.

void clearThemeOverrides()

Restaura todos los campos de token a los valores predeterminados del tema global.

const Colors& themeColorsRef() const

Acceso sin copia al conjunto de colores activo para rutas críticas de pintado.

Material::AcrylicToken themeAcrylic() const

Tokens de material, elevación y diseño adaptable.

QColor themeBackdrop(bool active) const

Color 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 Colors

Instantá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().

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