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.
No hay miembros de la API que coincidan.
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 EdgeBorde o línea central anclable.
NoneLeftRightTopBottomHCenterVCenter
Métodos
Anchors anchorsForWidget(QWidget* widget) constDevuelve 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 AnchorUna relación de anclaje desde un borde hasta el borde de un widget de destino.
struct AnchorsConjunto 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::PropertyLink
Hereda de QObject
Enlace en tiempo de ejecución que sincroniza una propiedad de QObject con otra.
Constructores
Métodos
Documentación de la clase base de Qt: QObject
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() constInforma si el enlace y sus extremos siguen siendo válidos.
bool isEnabled() constDevuelve el estado de habilitación con independencia de la pausa o suspensión de estado.
bool isSuspended() constInforma si hay una pausa manual o una invalidación de estado activa.
void setEnabled(bool enabled) constHabilita o deshabilita la sincronización; al habilitarla se actualiza de inmediato.
void pause() constMantiene el valor mostrado actual conservando el estado de habilitación.
void resume() constQuita la pausa manual y actualiza un enlace habilitado que no esté cubierto.
void refresh() constEvalúa un enlace activo de inmediato, omitiendo la programación diferida.
void unbind() constElimina 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 DirectionDirección de enlace.
OneWayTwoWay
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() constDevuelve el estado de destino lógico antes de completarse la animación.
bool isTransitionRunning() constInforma si las animaciones administradas de transición de estado están en ejecución.
Propiedades
QString stateDevuelve el estado de destino lógico antes de completarse la animación.
Lecturastate()NotificaciónstateChanged()bool transitionRunningInforma si las animaciones administradas de transición de estado están en ejecución.
LecturaisTransitionRunning()NotificacióntransitionRunningChanged()
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().
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.