Fluent-Qt

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.

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 Edge

Bord ou ligne centrale ancrable.

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

Méthodes

Anchors anchorsForWidget(QWidget* widget) const

Retourne 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 Anchor

Relation d'ancrage d'un bord vers le bord d'un widget cible.

struct Anchors

Jeu 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::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() const

Indique si la liaison et ses extrémités restent valides.

bool isEnabled() const

Retourne l'état d'activation indépendamment d'une mise en pause ou d'une suspension d'état.

bool isSuspended() const

Indique une pause manuelle ou une surcharge d'état active.

void setEnabled(bool enabled) const

Active ou désactive la synchronisation ; l'activation déclenche une actualisation immédiate.

void pause() const

Maintient la valeur affichée actuelle tout en préservant l'état d'activation.

void resume() const

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

Supprime 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 Direction

Direction de liaison.

  • OneWay
  • TwoWay

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

Retourne l'état de destination logique avant la fin de l'animation.

bool isTransitionRunning() const

Indique si les animations de transition d'état gérées sont en cours d'exécution.

Propriétés

QString state

Retourne l'état de destination logique avant la fin de l'animation.

Lecture state()Notification stateChanged()
bool transitionRunning

Indique si les animations de transition d'état gérées sont en cours d'exécution.

Lecture isTransitionRunning()Notification transitionRunningChanged()

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

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.

Membres protégés

Méthodes