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.
Keine passenden API-Elemente.
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 EdgeVerankerbare Kante oder Mittellinie.
NoneLeftRightTopBottomHCenterVCenter
Methoden
Anchors anchorsForWidget(QWidget* widget) constGibt 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 AnchorEine Ankerbeziehung von einer Kante zu einer Ziel-Widget-Kante.
struct AnchorsVollstä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::PropertyLink
Erbt von QObject
Laufzeitverknüpfung, die eine QObject-Eigenschaft mit einer anderen synchronisiert.
Konstruktoren
Methoden
Qt-Basisklassendokumentation: QObject
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() constMeldet, ob die Bindung und ihre Endpunkte gültig bleiben.
bool isEnabled() constGibt den Aktivierungsstatus unabhängig von Pause oder Zustandsaussetzung zurück.
bool isSuspended() constMeldet eine manuelle Pause oder eine aktive Zustandsüberschreibung.
void setEnabled(bool enabled) constAktiviert oder deaktiviert die Synchronisierung; beim Aktivieren erfolgt sofort eine Aktualisierung.
void pause() constBehält den aktuell angezeigten Wert bei und erhält den Aktivierungszustand.
void resume() constHebt die manuelle Pause auf und aktualisiert eine aktivierte, nicht überdeckte Bindung.
void refresh() constWertet ein aktives Binding sofort aus und umgeht dabei die verzögerte Planung.
void unbind() constEntfernt 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 DirectionBindungsrichtung.
OneWayTwoWay
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() constGibt den logischen Zielzustand vor Abschluss der Animation zurück.
bool isTransitionRunning() constMeldet, ob verwaltete Zustandsübergangsanimationen ausgeführt werden.
Eigenschaften
QString stateGibt den logischen Zielzustand vor Abschluss der Animation zurück.
Lesenstate()BenachrichtigungstateChanged()bool transitionRunningMeldet, ob verwaltete Zustandsübergangsanimationen ausgeführt werden.
LesenisTransitionRunning()BenachrichtigungtransitionRunningChanged()
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.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installiert eine verwaltete direkte Bindung auf diesem QWidget-Host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installiert einen C++-Ausdruck mit expliziten Abhängigkeiten auf diesem QWidget-Host.
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.