Fluent-Qt

Referencia de API

QMLPlus

Mixin que añade anclajes, enlaces de propiedades y estados simples a controles basados en QWidget. Los estados y runtime() requieren un host QObject; los ayudantes de anclaje y enlace orientados al host requieren QWidget.

fluent::AnchorLayout

Hereda de QLayout

Diseño ligero basado en anclajes para controles QWidget. Almacena anclajes de borde por hijo y resuelve las geometrías de los widgets durante los pases de diseño.

Constructores

Destructores

Enumeraciones

enum class Edge

Borde o línea central anclable.

  • None
  • Left
  • Right
  • Top
  • Bottom
  • HCenter
  • VCenter

Métodos

Anchors anchorsForWidget(QWidget* widget) const

Devuelve los anclajes actuales de un widget registrado.

bool setWidgetAnchors(QWidget* widget, const Anchors& anchors)

Reemplaza los anclajes de un widget registrado e invalida el diseño.

Tipos y alias

struct Anchor

Una relación de anclaje desde un borde hasta el borde de un widget de destino.

struct Anchors

Conjunto completo de anclajes para un widget hijo.

Documentación de la clase base de Qt: QLayout

fluent::AnchorLayout::Anchor

Una relación de anclaje desde un borde hasta el borde de un widget de destino.

Constructores

Campos

fluent::AnchorLayout::Anchors

Conjunto completo de anclajes para un widget hijo.

Constructores

Campos

fluent::BindingDependency

Dependencia de propiedad observable para un enlace calculado o una condición de estado. La propiedad debe ser legible y tener una señal NOTIFY en el hilo llamador.

Campos

fluent::BindingOptions

Habilitación inicial y fusión opcional en el bucle de eventos para un enlace.

Campos

fluent::BindingHandle

Manejador copiable de un enlace de propiedad gestionado por el objeto destino. Copiar o destruir el manejador no desenlaza la propiedad; llama a unbind() para eliminar el enlace de forma permanente.

Constructores

Métodos

bool isValid() const

Informa si el enlace y sus extremos siguen siendo válidos.

bool isEnabled() const

Devuelve el estado de habilitación con independencia de la pausa o suspensión de estado.

bool isSuspended() const

Informa si hay una pausa manual o una invalidación de estado activa.

void setEnabled(bool enabled) const

Habilita o deshabilita la sincronización; al habilitarla se actualiza de inmediato.

void pause() const

Mantiene el valor mostrado actual conservando el estado de habilitación.

void resume() const

Quita la pausa manual y actualiza un enlace habilitado que no esté cubierto.

void refresh() const

Evalúa un enlace activo de inmediato, omitiendo la programación diferida.

void unbind() const

Elimina permanentemente el enlace y conserva su valor mostrado actual.

fluent::PropertyBinder

Sincronización administrada de propiedades mediante metapropiedades de Qt y NOTIFY. Un reemplazo válido invalida el identificador de enlace anterior; una solicitud no válida deja intacto el enlace existente.

Enumeraciones

enum Direction

Dirección de enlace.

  • OneWay
  • TwoWay

Métodos

static void bind(QObject* source, const char* sPropName, QObject* target, const char* tPropName, Direction dir = OneWay)

Vincula @p sPropName en @p source con @p tPropName en @p target usando las señales NOTIFY disponibles. Ambos objetos deben residir en el hilo llamador; una llamada válida reemplaza cualquier enlace existente en la propiedad de destino.

static BindingHandle bindManaged(QObject* source, const char* sourceProp, QObject* target, const char* targetProp, Direction direction = OneWay, BindingOptions options = {})

Instala un enlace directo gestionado y sincroniza el valor inicial de inmediato. Ambos objetos deben residir en el hilo llamador; @p sourceProp requiere NOTIFY y @p targetProp debe ser grabable (TwoWay requiere que ambas direcciones sean legibles, grabables y notificadoras).

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

Instala un enlace de expresión C++ controlado por @p dependencies explícitas. La propiedad de destino debe ser legible y grabable; destruir cualquier dependencia invalida permanentemente el enlace.

fluent::PropertyChange

Asignación de propiedad aplicada por un estado de QMLPlus.

Campos

fluent::AnchorChange

Conjunto completo de anclajes de reemplazo aplicado y restaurado por un estado.

Campos

fluent::QMLState

Conjunto con nombre de cambios de propiedades.

Campos

fluent::PropertyAnimation

Ajustes de animación para escrituras de propiedades gestionadas, respetando MotionPolicy.

Campos

fluent::StateTransition

Animación seleccionada para cambios de estado coincidentes; una lista properties vacía coincide con todas las propiedades. from/to vacío coincide con el estado predeterminado y "*" coincide con cualquier estado; los cambios de anclaje no se animan.

Campos

fluent::QMLPlusRuntime

Hereda de QObject

Observador creado de forma diferida para transiciones de estado de QMLPlus, propiedad del host QObject. Emite transitionFinished() una vez cuando una transición se estabiliza, incluidos los cambios inmediatos, salvo que se interrumpa.

Destructores

Métodos

QString state() const

Devuelve el estado de destino lógico antes de completarse la animación.

bool isTransitionRunning() const

Informa si las animaciones administradas de transición de estado están en ejecución.

Propiedades

QString state

Devuelve el estado de destino lógico antes de completarse la animación.

Lectura state()Notificación stateChanged()
bool transitionRunning

Informa si las animaciones administradas de transición de estado están en ejecución.

Lectura isTransitionRunning()Notificación transitionRunningChanged()

Señales

void stateChanged(const QString& state)

Devuelve el estado de destino lógico antes de completarse la animación.

void transitionRunningChanged(bool running)

Informa si las animaciones administradas de transición de estado están en ejecución.

Documentación de la clase base de Qt: QObject

fluent::QMLPlus

Constructores

Destructores

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.

Miembros protegidos

Métodos