Row QML Type

Ordnet seine untergeordneten Elemente in einer Reihe an. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : 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

„Row“ ist ein Typ, der seine untergeordneten Elemente in einer einzigen Zeile anordnet. Er bietet eine bequeme Möglichkeit, eine Reihe von Elementen horizontal anzuordnen, ohne Anker zu verwenden.

Nachfolgend sehen Sie eine „Row“, 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 „Row“ ordnet diese Elemente automatisch horizontal an, und zwar wie folgt:

Wenn ein Element innerhalb einer „Row“ nicht „ visible “ ist oder eine Breite oder Höhe von 0 aufweist, wird das Element nicht angeordnet und ist innerhalb der Zeile nicht sichtbar. Da eine „Row“ ihre untergeordneten Elemente automatisch horizontal anordnet, sollte ein untergeordnetes Element innerhalb einer „Row“ außerdem keine „ x “-Position festlegen oder sich mithilfe der Anker „ left “, „ right “, „ anchors.horizontalCenter “, „ fill “ oder „ centerIn “ horizontal verankern. Wenn Sie diese Aktionen ausführen müssen, sollten Sie in Erwägung ziehen, die Elemente ohne Verwendung einer Zeile zu positionieren.

Beachten Sie, dass Elemente in einer Zeile die angehängte Eigenschaft „ Positioner “ verwenden können, um auf weitere Informationen zu ihrer Position innerhalb der Zeile zuzugreifen.

Weitere Informationen zur Verwendung von „Row“ und anderen verwandten Positionierungstypen finden Sie unter „Elementpositionierer“.

Siehe auch „ Column“ , „ Grid “, „ Flow “, „ Positioner “, „ RowLayout “ 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. Für einen Positionierer gilt dies für:

• Elemente, die nach der Erstellung des Positionierers als untergeordnete Elemente des Positionierers 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 die Eigenschaft „ ViewTransition “ nutzen, um auf weitere Details des hinzugefügten Elements zuzugreifen. 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 der Zeile fest.

Bei Verwendung der angehängten Eigenschaft „ LayoutMirroring::enabled “ für lokalisierte Layouts wird die visuelle Ausrichtungsrichtung 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:

Siehe auch Grid::layoutDirection und Flow::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 zu dem Element zuzugreifen, das verschoben wird. Beachten Sie jedoch, dass bei diesem „Move“-Ü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 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 Positioners sind. Der Übergang wird ausgeführt, wenn der Positioner zum ersten Mal erstellt wird.

Der Übergang kann die Eigenschaft „ ViewTransition “ nutzen, um auf weitere Details zum hinzugefügten Element zuzugreifen. Weitere Informationen 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 benachbarten Elementen. Der Standardabstand beträgt 0.

Siehe auch Grid::spacing.

Signal-Dokumentation

positioningComplete()

Dieses Signal wird ausgegeben, wenn die Positionierung abgeschlossen ist.

Methodendokumentation

void forceLayout()

„Row“ 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, „Row“ jedoch noch nicht entsprechend aktualisiert wurde.

Diese Methode zwingt die Row, sofort auf alle ausstehenden Änderungen an ihren untergeordneten Elementen zu reagieren.

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