Référence API
QMLPlus
Mixin ajoutant des ancrages, des liaisons de propriétés et des états simples aux contrôles basés sur QWidget. Les états et runtime() nécessitent un hôte QObject ; les assistants d'ancrage et de liaison ciblant l'hôte nécessitent QWidget.
Aucun membre d'API correspondant.
fluent::AnchorLayout
Hérite de QLayout
Disposition légère par ancres pour les contrôles QWidget. Stocke les ancres de bord par enfant et résout les géométries des widgets lors des passes de mise en page.
Constructeurs
Destructeurs
Énumérations
enum class EdgeBord ou ligne centrale ancrable.
NoneLeftRightTopBottomHCenterVCenter
Méthodes
Anchors anchorsForWidget(QWidget* widget) constRetourne les ancres actuelles d'un widget enregistré.
bool setWidgetAnchors(QWidget* widget, const Anchors& anchors)Remplace les ancres d'un widget enregistré et invalide la mise en page.
Types et alias
struct AnchorRelation d'ancrage d'un bord vers le bord d'un widget cible.
struct AnchorsJeu complet d'ancrages pour un widget enfant.
Documentation de la classe de base Qt : QLayout
fluent::AnchorLayout::Anchor
Relation d'ancrage d'un bord vers le bord d'un widget cible.
Constructeurs
Champs
fluent::AnchorLayout::Anchors
Jeu complet d'ancrages pour un widget enfant.
Constructeurs
Champs
fluent::PropertyLink
Hérite de QObject
Lien d'exécution qui synchronise une propriété QObject vers une autre.
Constructeurs
Méthodes
Documentation de la classe de base Qt : QObject
fluent::BindingDependency
Dépendance de propriété observable pour une liaison calculée ou une condition d'état. La propriété doit être lisible avec un signal NOTIFY sur le thread appelant.
Champs
fluent::BindingOptions
Activation initiale et fusion optionnelle dans la boucle d'événements pour une liaison.
Champs
fluent::BindingHandle
Handle copiable vers une liaison de propriété gérée par l'objet cible. Copier ou détruire le handle ne supprime pas la liaison ; appelez unbind() pour la retirer définitivement.
Constructeurs
Méthodes
bool isValid() constIndique si la liaison et ses extrémités restent valides.
bool isEnabled() constRetourne l'état d'activation indépendamment d'une mise en pause ou d'une suspension d'état.
bool isSuspended() constIndique une pause manuelle ou une surcharge d'état active.
void setEnabled(bool enabled) constActive ou désactive la synchronisation ; l'activation déclenche une actualisation immédiate.
void pause() constMaintient la valeur affichée actuelle tout en préservant l'état d'activation.
void resume() constSupprime la pause manuelle et actualise une liaison activée et non recouverte.
void refresh() constÉvalue immédiatement une liaison active, en contournant la planification différée.
void unbind() constSupprime définitivement la liaison et conserve la valeur affichée actuelle.
fluent::PropertyBinder
Synchronisation gérée des propriétés via les méta-propriétés Qt et NOTIFY. Un remplacement valide invalide l'ancien handle de liaison ; une requête invalide laisse la liaison existante intacte.
Énumérations
enum DirectionDirection de liaison.
OneWayTwoWay
Méthodes
static void bind(QObject* source, const char* sPropName, QObject* target, const char* tPropName, Direction dir = OneWay)Lie @p sPropName sur @p source à @p tPropName sur @p target à l'aide des signaux NOTIFY disponibles. Les deux objets doivent résider sur le thread appelant ; un appel valide remplace toute liaison existante sur la propriété cible.
static BindingHandle bindManaged(QObject* source, const char* sourceProp, QObject* target, const char* targetProp, Direction direction = OneWay, BindingOptions options = {})Installe une liaison directe gérée et synchronise immédiatement la valeur initiale. Les deux objets doivent résider sur le thread appelant ; @p sourceProp nécessite NOTIFY et @p targetProp doit être accessible en écriture (TwoWay exige que les deux sens soient accessibles en lecture, en écriture et dotés d'une notification).
static BindingHandle bindComputed(QObject* target, const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installe une liaison d'expression C++ pilotée par des @p dependencies explicites. La propriété cible doit être accessible en lecture et en écriture ; la destruction de toute dépendance invalide définitivement la liaison.
fluent::PropertyChange
Affectation de propriété appliquée par un état QMLPlus.
Champs
fluent::AnchorChange
Jeu complet d'ancrages de remplacement appliqué et restauré par un état.
Champs
fluent::QMLState
Ensemble nommé de modifications de propriétés.
Champs
fluent::PropertyAnimation
Paramètres d'animation pour les écritures de propriétés gérées, respectant MotionPolicy.
Champs
fluent::StateTransition
Animation sélectionnée pour les changements d'état correspondants ; une liste properties vide correspond à toutes les propriétés. Une valeur from/to vide correspond à l'état par défaut, et "*" à n'importe quel état ; les changements d'ancre ne sont pas animés.
Champs
fluent::QMLPlusRuntime
Hérite de QObject
Observateur créé à la demande pour les transitions d'état QMLPlus, détenu par l'hôte QObject. Émet transitionFinished() une fois la transition stabilisée, y compris lors de basculements immédiats, sauf interruption.
Destructeurs
Méthodes
QString state() constRetourne l'état de destination logique avant la fin de l'animation.
bool isTransitionRunning() constIndique si les animations de transition d'état gérées sont en cours d'exécution.
Propriétés
QString stateRetourne l'état de destination logique avant la fin de l'animation.
Lecturestate()NotificationstateChanged()bool transitionRunningIndique si les animations de transition d'état gérées sont en cours d'exécution.
LectureisTransitionRunning()NotificationtransitionRunningChanged()
Signaux
void stateChanged(const QString& state)Retourne l'état de destination logique avant la fin de l'animation.
void transitionRunningChanged(bool running)Indique si les animations de transition d'état gérées sont en cours d'exécution.
Documentation de la classe de base Qt : QObject
fluent::QMLPlus
Constructeurs
Destructeurs
Méthodes
AnchorLayout::Anchors* anchors()Retourne les ancres modifiables pour l'hôte QWidget.
void setState(const QString& name)Applique un état enregistré par son nom, ou restaure l'état par défaut lorsque @p name est vide. Les noms inconnus sont ignorés et les liaisons existantes reprennent à la sortie de l'état.
void addState(const QMLState& state)Enregistre ou remplace une définition d'état nommée ; remplacer l'état actif l'applique immédiatement.
void evaluateStates()Réévalue les conditions d'état dans l'ordre d'enregistrement et active la première correspondance, ou l'état par défaut si aucune ne correspond. S'exécute aussi automatiquement lorsque les propriétés dépendantes notifient ; les états dérivés utilisant extend héritent des modifications ancêtres sauf en cas de cycle ou d'absence.
QMLPlusRuntime* runtime()Retourne l'observateur d'état créé à la demande et détenu par cet hôte.
void setAnchors(const AnchorLayout::Anchors& anchors)Remplace toutes les ancres de l'hôte et invalide la mise en page parente.
void resetAnchors()Efface tous les ancrages de l'hôte et invalide la mise en page parente.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Lie @p sourceProp sur @p source à @p targetProp sur cet hôte QWidget via PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installe une liaison directe gérée sur cet hôte QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installe une expression C++ à dépendances explicites sur cet hôte QWidget.
void addTransition(const StateTransition& transition)Enregistre une transition d'état par ordre de priorité.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Définit l'animation par défaut utilisée lorsque @p propertyName est modifié via writeProperty() ou une liaison. Les règles StateTransition explicites ont la priorité ; les appels directs aux setters C++ ne sont pas animés.
void clearBehavior(const char* propertyName)Supprime l'animation par défaut pour les futures écritures gérées.
bool writeProperty(const char* propertyName, const QVariant& value)Écrit une propriété hôte via Behavior sans supprimer sa liaison.