Flow QML Type

Ordnet seine untergeordneten Elemente nebeneinander an und bricht die Zeilen bei Bedarf um. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• flow : enumeration
• layoutDirection : enumeration
• leftPadding : real
• move : Transition
• padding : real
• populate : Transition
• rightPadding : real
• spacing : real
• topPadding : real

Signale

• positioningComplete()

Methoden

• void forceLayout()

Ausführliche Beschreibung

Das „Flow“-Element positioniert seine untergeordneten Elemente wie Wörter auf einer Seite und bricht sie so um, dass Zeilen oder Spalten von Elementen entstehen.

Nachfolgend sehen Sie ein „Flow“-Element, das verschiedene „ Text “-Elemente enthält:

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

Das Flow-Element positioniert die untergeordneten „ Text “-Elemente automatisch nebeneinander und bricht sie bei Bedarf um:

Wenn ein Element innerhalb eines „Flow“ kein „ visible “-Element ist oder eine Breite oder Höhe von 0 hat, wird das Element nicht angeordnet und ist innerhalb des „Flow“ nicht sichtbar. Da ein „Flow“ seine untergeordneten Elemente automatisch positioniert, sollte ein untergeordnetes Element innerhalb eines „Flow“ außerdem keine „ x “- oder „ y “-Positionen festlegen oder sich mit einer der „ anchor “-Eigenschaften verankern.

Weitere Informationen zur Verwendung von „Flow“ und anderen verwandten Positionierertypen finden Sie unter „Element-Positionierer“.

Siehe auch „ Column“ , „ Row “, „ Grid “, „ Positioner “ und „Qt Quick “ – Beispiele: Positionierer.

Dokumentation zu den Eigenschaften

add : Transition

Diese Eigenschaft enthält den Übergang, der für Elemente ausgeführt werden soll, die diesem Positionierer hinzugefügt werden. Bei einem Positionierer gilt dies für:

• Elemente, die nach der Erstellung des Positioners als untergeordnete Elemente des Positioners erstellt oder neu zugeordnet werden
• Unterelemente, deren Eigenschaft „ Item::visible “ von „false“ auf „true“ geändert wird und die somit nun sichtbar sind

Der Übergang kann über die Eigenschaft „ ViewTransition “ auf weitere Details zum hinzugefügten Element zugreifen. Weitere Details und Beispiele zur Verwendung dieser Übergänge finden Sie in der Dokumentation unter „ ViewTransition “.

Siehe auch „ populate“ , „ ViewTransition “ und „Qt Quick – Beispiele: Positioner“.

Diese Eigenschaften legen den Abstand um den Inhalt herum fest.

effectiveLayoutDirection : enumeration [read-only]

Diese Eigenschaft legt die tatsächliche Layout-Richtung des Flusses fest.

Bei Verwendung der angehängten Eigenschaft „ LayoutMirroring::enabled “ für lokalisierte Layouts wird die visuelle Ausrichtungsrichtung des Rasterpositionierers gespiegelt. Die Eigenschaft „ layoutDirection “ bleibt jedoch unverändert.

Siehe auch „ Flow::layoutDirection “ und „ LayoutMirroring “.

flow : enumeration

Diese Eigenschaft bestimmt den Ablauf des Layouts.

Mögliche Werte sind:

• Flow.LeftToRight (Standard) – Elemente werden gemäß der „ layoutDirection “ nebeneinander angeordnet, bis die Breite des Flusses überschritten wird; anschließend erfolgt ein Zeilenumbruch in die nächste Zeile.
• Flow.TopToBottom – Elemente werden von oben nach unten nebeneinander angeordnet, bis die Höhe des Flusses überschritten wird; danach erfolgt ein Umbruch in die nächste Spalte.

layoutDirection : enumeration

Diese Eigenschaft gibt die Ausrichtungsrichtung des Layouts an.

Mögliche Werte sind:

• Qt.LeftToRight (Standard) – Elemente werden von oben nach unten und von links nach rechts positioniert. Die Fließrichtung hängt von der Eigenschaft „ Flow::flow “ ab.
• Qt.RightToLeft – Elemente werden von oben nach unten und von rechts nach links angeordnet. Die Fließrichtung hängt von der Eigenschaft „ Flow::flow “ ab.

Siehe auch „ Grid::layoutDirection “ und „ Row::layoutDirection “.

move : Transition

Diese Eigenschaft legt fest, dass der Übergang für Elemente ausgeführt wird, die sich innerhalb des Positionierers verschoben haben. Für einen Positionierer gilt dies für:

• Untergeordnete Elemente, die sich verschieben, wenn sie durch das Hinzufügen, Entfernen oder Neuanordnen anderer Elemente im Positionierer verschoben werden
• Untergeordnete Elemente, die aufgrund der Größenänderung anderer Elemente im Positionierer neu positioniert werden

Der Übergang kann die Eigenschaft „ ViewTransition “ verwenden, um auf weitere Details zum verschobenen Element zuzugreifen. Beachten Sie jedoch, dass bei diesem Verschiebungsübergang die Listen „ ViewTransition.targetIndexes“ und „ ViewTransition.targetItems“ nur dann gesetzt werden, wenn dieser Übergang durch das Hinzufügen anderer Elemente im Positionierer ausgelöst wird; in allen anderen Fällen sind diese Listen leer. Weitere Details und Beispiele zur Verwendung dieser Übergänge finden Sie in der Dokumentation unter ViewTransition.

Siehe auch add, populate, ViewTransition und Qt Quick Beispiele – Positionierer.

populate : Transition

Diese Eigenschaft enthält den Übergang, der für Elemente ausgeführt werden soll, die zum Zeitpunkt der Erstellung Teil dieses Positionierers sind. Der Übergang wird ausgeführt, wenn der Positionierer zum ersten Mal erstellt wird.

Der Übergang kann die Eigenschaft „ ViewTransition “ verwenden, um auf weitere Details zu dem Element zuzugreifen, das hinzugefügt wird. Weitere Details und Beispiele zur Verwendung dieser Übergänge finden Sie in der Dokumentation unter ViewTransition.

Siehe auch „ add“ , „ ViewTransition “ und „Qt Quick: Beispiele – Positioner“.

spacing : real

Der Abstand ist der in Pixeln angegebene Freiraum zwischen zwei benachbarten Elementen und beträgt standardmäßig 0.

Siehe auch Grid::spacing.

Signal-Dokumentation

positioningComplete()

Dieses Signal wird ausgegeben, wenn die Positionierung abgeschlossen ist.

Methodendokumentation

void forceLayout()

Flow positioniert seine untergeordneten Elemente in der Regel einmal pro Frame. Das bedeutet, dass sich innerhalb von Skriptblöcken die zugrunde liegenden untergeordneten Elemente möglicherweise geändert haben, der Flow jedoch noch nicht entsprechend aktualisiert wurde.

Diese Methode zwingt den Flow dazu, sofort auf alle ausstehenden Änderungen an seinen untergeordneten Elementen zu reagieren.

Hinweis: Methoden sollten generell erst aufgerufen werden, nachdem die Komponente fertiggestellt ist.