Fluent-Qt

API-Referenz

QMLPlus

Mixin, das QWidget-basierten Steuerelementen Anker, Eigenschaftsbindungen und einfache Zustände hinzufügt. Zustände und runtime() erfordern einen QObject-Host; Anker- und hostbezogene Bindungshilfen erfordern QWidget.

fluent::AnchorLayout

Erbt von QLayout

Leichtgewichtiges ankerbasiertes Layout für QWidget-Steuerelemente. Speichert Kantenanker pro Kind-Element und löst Widget-Geometrien während der Layout-Durchläufe auf.

Konstruktoren

Destruktoren

Enumerationen

enum class Edge

Verankerbare Kante oder Mittellinie.

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

Methoden

Anchors anchorsForWidget(QWidget* widget) const

Gibt die aktuellen Anker für ein registriertes Widget zurück.

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

Ersetzt die Anker eines registrierten Widgets und macht das Layout ungültig.

Typen und Aliase

struct Anchor

Eine Ankerbeziehung von einer Kante zu einer Ziel-Widget-Kante.

struct Anchors

Vollständiger Ankersatz für ein untergeordnetes Widget.

Qt-Basisklassendokumentation: QLayout

fluent::AnchorLayout::Anchor

Eine Ankerbeziehung von einer Kante zu einer Ziel-Widget-Kante.

Konstruktoren

Felder

fluent::AnchorLayout::Anchors

Vollständiger Ankersatz für ein untergeordnetes Widget.

Konstruktoren

Felder

fluent::BindingDependency

Beobachtbare Eigenschaftsabhängigkeit für eine berechnete Bindung oder Zustandsbedingung. Die Eigenschaft muss lesbar sein und ein NOTIFY-Signal im aufrufenden Thread besitzen.

Felder

fluent::BindingOptions

Anfänglicher Aktivierungszustand und optionale Event-Loop-Zusammenfassung für eine Bindung.

Felder

fluent::BindingHandle

Kopierbares Handle auf eine vom Zielobjekt verwaltete Eigenschaftsbindung. Das Kopieren oder Zerstören des Handles hebt die Bindung nicht auf; rufen Sie unbind() auf, um die Bindung dauerhaft zu entfernen.

Konstruktoren

Methoden

bool isValid() const

Meldet, ob die Bindung und ihre Endpunkte gültig bleiben.

bool isEnabled() const

Gibt den Aktivierungsstatus unabhängig von Pause oder Zustandsaussetzung zurück.

bool isSuspended() const

Meldet eine manuelle Pause oder eine aktive Zustandsüberschreibung.

void setEnabled(bool enabled) const

Aktiviert oder deaktiviert die Synchronisierung; beim Aktivieren erfolgt sofort eine Aktualisierung.

void pause() const

Behält den aktuell angezeigten Wert bei und erhält den Aktivierungszustand.

void resume() const

Hebt die manuelle Pause auf und aktualisiert eine aktivierte, nicht überdeckte Bindung.

void refresh() const

Wertet ein aktives Binding sofort aus und umgeht dabei die verzögerte Planung.

void unbind() const

Entfernt die Bindung dauerhaft und behält den aktuell angezeigten Wert bei.

fluent::PropertyBinder

Verwaltete Eigenschaftssynchronisierung über Qt-Meta-Properties und NOTIFY. Ein gültiger Ersatz macht das alte Binding-Handle ungültig; eine ungültige Anfrage lässt die bestehende Bindung unverändert.

Enumerationen

enum Direction

Bindungsrichtung.

  • OneWay
  • TwoWay

Methoden

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

Bindet @p sPropName von @p source an @p tPropName von @p target über verfügbare NOTIFY-Signale. Beide Objekte müssen im aufrufenden Thread leben; ein gültiger Aufruf ersetzt jede bestehende Bindung an der Zieleigenschaft.

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

Installiert eine verwaltete direkte Bindung und synchronisiert den Anfangswert sofort. Beide Objekte müssen im aufrufenden Thread leben; @p sourceProp erfordert NOTIFY und @p targetProp muss schreibbar sein (TwoWay erfordert in beide Richtungen Lesbarkeit, Schreibbarkeit und Benachrichtigung).

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

Installiert eine durch explizite @p dependencies gesteuerte C++-Ausdrucksbindung. Die Zieleigenschaft muss les- und schreibbar sein; das Zerstören einer Abhängigkeit macht die Bindung dauerhaft ungültig.

fluent::PropertyChange

Von einem QMLPlus-Zustand angewendete Eigenschaftszuweisung.

Felder

fluent::AnchorChange

Vollständiger Ersatz-Ankersatz, der von einem Zustand angewendet und wiederhergestellt wird.

Felder

fluent::QMLState

Benannter Satz von Eigenschaftsänderungen.

Felder

fluent::PropertyAnimation

Animationseinstellungen für verwaltete Eigenschaftszuweisungen unter Berücksichtigung von MotionPolicy.

Felder

fluent::StateTransition

Für passende Zustandswechsel ausgewählte Animation; eine leere properties-Liste passt auf alle Eigenschaften. Leeres from/to passt auf den Standardzustand und "*" auf jeden Zustand; Ankeränderungen werden nicht animiert.

Felder

fluent::QMLPlusRuntime

Erbt von QObject

Bei Bedarf erstellter Beobachter für QMLPlus-Zustandsübergänge im Besitz des QObject-Hosts. Sendet transitionFinished() einmalig, sobald ein Übergang abgeschlossen ist (einschließlich direkter Wechsel), sofern er nicht unterbrochen wird.

Destruktoren

Methoden

QString state() const

Gibt den logischen Zielzustand vor Abschluss der Animation zurück.

bool isTransitionRunning() const

Meldet, ob verwaltete Zustandsübergangsanimationen ausgeführt werden.

Eigenschaften

QString state

Gibt den logischen Zielzustand vor Abschluss der Animation zurück.

Lesen state()Benachrichtigung stateChanged()
bool transitionRunning

Meldet, ob verwaltete Zustandsübergangsanimationen ausgeführt werden.

Lesen isTransitionRunning()Benachrichtigung transitionRunningChanged()

Signale

void stateChanged(const QString& state)

Gibt den logischen Zielzustand vor Abschluss der Animation zurück.

void transitionRunningChanged(bool running)

Meldet, ob verwaltete Zustandsübergangsanimationen ausgeführt werden.

Qt-Basisklassendokumentation: QObject

fluent::QMLPlus

Konstruktoren

Destruktoren

Methoden

AnchorLayout::Anchors* anchors()

Gibt veränderbare Anker für den QWidget-Host zurück.

void setState(const QString& name)

Wendet einen registrierten Zustand anhand seines Namens an oder stellt den Standardzustand wieder her, wenn @p name leer ist. Unbekannte Namen werden ignoriert, und bestehende Bindungen werden beim Verlassen des Zustands wieder aufgenommen.

void addState(const QMLState& state)

Registriert oder ersetzt eine benannte Zustandsdefinition; das Ersetzen des aktiven Zustands wendet diesen sofort an.

void evaluateStates()

Wertet Zustandsbedingungen in Registrierungsreihenfolge neu aus und aktiviert den ersten Treffer oder den Standardzustand, wenn keiner zutrifft. Wird auch automatisch bei Benachrichtigungen abhängiger Eigenschaften ausgeführt; abgeleitete Zustände mit extend erben Änderungen der Vorgänger, sofern keine Zyklen vorliegen oder Vorgänger fehlen.

QMLPlusRuntime* runtime()

Gibt den bei Bedarf erstellten Zustandsbeobachter im Besitz dieses Hosts zurück.

void setAnchors(const AnchorLayout::Anchors& anchors)

Ersetzt alle Host-Anker und macht das übergeordnete Layout ungültig.

void resetAnchors()

Löscht alle Host-Anker und invalidiert das übergeordnete Layout.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Bindet @p sourceProp von @p source über PropertyBinder::bind() an @p targetProp dieses QWidget-Hosts.

void addTransition(const StateTransition& transition)

Registriert einen Zustandsübergang in Prioritätsreihenfolge.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Setzt die Standardanimation, die beim Schreiben von @p propertyName über writeProperty() oder eine Bindung verwendet wird. Explizite StateTransition-Regeln haben Vorrang; direkte C++-Setter-Aufrufe werden nicht animiert.

void clearBehavior(const char* propertyName)

Entfernt die Standardanimation für zukünftige verwaltete Schreibvorgänge.

bool writeProperty(const char* propertyName, const QVariant& value)

Schreibt eine Host-Eigenschaft über Behavior, ohne deren Bindung zu entfernen.

Geschützte Elemente

Methoden