Row QML Type
Positioniert seine Kinder in einer Reihe. Mehr...
| Import Statement: | import QtQuick |
| Inherits: |
Eigenschaften
- add : Transition
- bottomPadding : real
- effectiveLayoutDirection : enumeration
- layoutDirection : enumeration
- leftPadding : real
- move : Transition
- padding : real
- populate : Transition
- rightPadding : real
- spacing : real
- topPadding : real
Signale
Methoden
Ausführliche Beschreibung
Row ist ein Typ, der seine untergeordneten Elemente in einer einzigen Zeile positioniert. Er kann als praktische Möglichkeit verwendet werden, um eine Reihe von Elementen horizontal zu positionieren, ohne Anker zu verwenden.
Nachfolgend sehen Sie eine Zeile, die drei Rechtecke unterschiedlicher Größe enthält:
import QtQuick Row { spacing: 2 Rectangle { color: "red"; width: 50; height: 50 } Rectangle { color: "green"; width: 20; height: 50 } Rectangle { color: "blue"; width: 50; height: 20 } }
Die Reihe positioniert diese Elemente automatisch in einer horizontalen Formation, etwa so:
Wenn ein Element in einer Zeile nicht visible ist oder wenn es eine Breite oder Höhe von 0 hat, wird das Element nicht angeordnet und ist in der Zeile nicht sichtbar. Da eine Zeile ihre untergeordneten Elemente automatisch horizontal positioniert, sollte ein untergeordnetes Element innerhalb einer Zeile nicht seine Position x festlegen oder sich mit den Ankern left, right, anchors.horizontalCenter, fill oder centerIn horizontal verankern. Wenn Sie diese Aktionen durchführen müssen, sollten Sie die Positionierung der Elemente ohne die Verwendung einer Zeile in Betracht ziehen.
Beachten Sie, dass Elemente in einer Zeile die angehängte Eigenschaft Positioner verwenden können, um weitere Informationen über ihre Position innerhalb der Zeile zu erhalten.
Weitere Informationen zur Verwendung von Row und anderen verwandten Positionierer-Typen finden Sie unter Elementpositionierer.
Siehe auch Column, Grid, Flow, Positioner, RowLayout, und Qt Quick Beispiele - Positionierer.
Dokumentation der Eigenschaft
Diese Eigenschaften enthalten die Polsterung um den Inhalt.
add : Transition |
Diese Eigenschaft enthält den Übergang, der für Elemente, die diesem Positionierer hinzugefügt werden, ausgeführt wird. Für einen Positionierer gilt dies für:
- Elemente, die als untergeordnetes Element des Positionierers erstellt oder repariert werden, nachdem der Positionierer erstellt wurde
- Untergeordnete Elemente, die ihre Item::visible -Eigenschaft von "false" auf "true" ändern und somit jetzt sichtbar sind
Der Übergang kann die Eigenschaft ViewTransition verwenden, um auf weitere Details über das hinzugefügte Element zuzugreifen. In der Dokumentation ViewTransition finden Sie weitere Details und Beispiele zur Verwendung dieser Übergänge.
Hinweis: Dieser Übergang wird nicht auf die Elemente angewendet, die zum Zeitpunkt der Erstellung bereits Teil des Positionierers sind. In diesem Fall wird stattdessen der Übergang populate angewendet.
Siehe auch populate, ViewTransition, und Qt Quick Beispiele - Positionierer.
effectiveLayoutDirection : enumeration |
Diese Eigenschaft enthält die effektive Layout-Richtung der Zeile.
Wenn Sie die angehängte Eigenschaft LayoutMirroring::enabled für Gebietsschema-Layouts verwenden, wird die visuelle Layout-Richtung des Zeilenpositionierers gespiegelt. Die Eigenschaft layoutDirection bleibt jedoch unverändert.
Siehe auch Row::layoutDirection und LayoutMirroring.
layoutDirection : enumeration |
Diese Eigenschaft enthält die layoutDirection der Zeile.
Mögliche Werte:
| Konstant | Beschreibung |
|---|---|
Qt.LeftToRight | (Standard) Die Elemente werden von links nach rechts angeordnet. Wenn die Breite der Zeile explizit festgelegt ist, bleibt der linke Anker links von der Zeile. |
Qt.RightToLeft | Die Elemente werden von rechts nach links angeordnet. Wenn die Breite der Zeile explizit festgelegt ist, bleibt der rechte Anker rechts von der Zeile. |
Siehe auch Grid::layoutDirection und Flow::layoutDirection.
move : Transition |
Diese Eigenschaft enthält den Übergang, der für Elemente ausgeführt werden soll, die innerhalb des Positionierers verschoben wurden. Für einen Positionierer gilt dies für:
- Untergeordnete Elemente, die sich verschieben, wenn sie aufgrund des Hinzufügens, Entfernens oder Neuanordnens anderer Elemente in der Positioniervorrichtung 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 über das zu verschiebende Element zuzugreifen. Beachten Sie jedoch, dass für diesen Verschiebeübergang die Listen ViewTransition.targetIndexes und ViewTransition.targetItems nur gesetzt werden, wenn dieser Übergang durch das Hinzufügen anderer Elemente im Positionierer ausgelöst wird; in anderen Fällen sind diese Listen leer. In der Dokumentation ViewTransition finden Sie weitere Einzelheiten und Beispiele zur Verwendung dieser Übergänge.
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 dieses Positionierers Teil davon 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 über das hinzugefügte Element zuzugreifen. In der Dokumentation ViewTransition finden Sie weitere Einzelheiten und Beispiele zur Verwendung dieser Übergänge.
Siehe auch add, ViewTransition, und Qt Quick Beispiele - Positionierer.
spacing : real |
Der Abstand ist die Menge in Pixeln, die zwischen benachbarten Elementen frei bleibt. Der Standardabstand ist 0.
Siehe auch Grid::spacing.
Signal Dokumentation
positioningComplete() |
Dieses Signal wird ausgegeben, wenn die Positionierung abgeschlossen ist.
Hinweis: Der entsprechende Handler ist onPositioningComplete.
Dokumentation der Methode
forceLayout() |
Row positioniert seine Kinder normalerweise einmal pro Frame. Das bedeutet, dass es innerhalb von Skriptblöcken möglich ist, dass sich die zugrundeliegenden Kinder geändert haben, aber die Zeile noch nicht entsprechend aktualisiert wurde.
Diese Methode zwingt die Zeile dazu, sofort auf alle ausstehenden Änderungen in ihren Childs zu reagieren.
Hinweis: Methoden sollten im Allgemeinen erst aufgerufen werden, wenn die Komponente abgeschlossen ist.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
