PathAttribute QML Type

Gibt an, wie ein Attribut an einer bestimmten Position in einem Pfad gesetzt werden soll. Mehr...

Import Statement: import QtQuick

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

name : string
value : real

Detaillierte Beschreibung

Das PathAttribute-Objekt ermöglicht die Angabe von Attributen, die aus einem Namen und einem Wert bestehen, für verschiedene Punkte entlang eines Pfades. Die Attribute werden dem Delegierten als angehängte Eigenschaften angezeigt. Der Wert eines Attributs an einem bestimmten Punkt entlang des Pfades wird aus den PathAttributes interpoliert, die diesen Punkt begrenzen.

Das folgende Beispiel zeigt einen Pfad mit den Elementen, die auf 30 % skaliert sind, mit einer Deckkraft von 50 % am oberen Ende des Pfades und mit einer Skalierung von 100 % mit einer Deckkraft von 100 % am unteren Ende. Beachten Sie die Verwendung der angehängten Eigenschaften PathView.iconScale und PathView.iconOpacity, um die Skalierung und Deckkraft des Delegaten festzulegen.

import QtQuick

Rectangle {
    width: 240; height: 200

    Component {
        id: delegate
        Item {
            width: 80; height: 80
            scale: PathView.iconScale
            opacity: PathView.iconOpacity
            Column {
                Image { anchors.horizontalCenter: nameText.horizontalCenter; width: 64; height: 64; source: icon }
                Text { id: nameText; text: name; font.pointSize: 16 }
            }
        }
    }

    PathView {
        anchors.fill: parent
        model: ContactModel {}
        delegate: delegate
        path: Path {
            startX: 120; startY: 100
            PathAttribute { name: "iconScale"; value: 1.0 }
            PathAttribute { name: "iconOpacity"; value: 1.0 }
            PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 }
            PathAttribute { name: "iconScale"; value: 0.3 }
            PathAttribute { name: "iconOpacity"; value: 0.5 }
            PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 }
        }
    }
}

(siehe die PathView Dokumentation für die Spezifikation von ContactModel.qml, die für ContactModel oben verwendet wird).

Siehe auch Path.

Eigenschaft Dokumentation

name : string

Diese Eigenschaft enthält den Namen des zu ändernden Attributs.

Dieses Attribut wird dem Delegierten als PathView.<name> zur Verfügung stehen.

Beachten Sie, dass die Verwendung eines bestehenden Item-Eigenschaftsnamens wie "opacity" als Attribut zulässig ist. Dies liegt daran, dass Pfadattribute eine neue angehängte Eigenschaft hinzufügen, die in keiner Weise mit bestehenden Eigenschaften kollidiert.

value : real

Diese Eigenschaft enthält den Wert für das Attribut.

Der angegebene Wert kann verwendet werden, um das visuelle Erscheinungsbild eines Elements entlang des Pfads zu beeinflussen. Der folgende Pfad gibt zum Beispiel ein Attribut namens itemRotation an, das am Anfang des Pfades den Wert 0 und am Ende des Pfades den Wert 90 hat.

Path {
    startX: 0
    startY: 0
    PathAttribute { name: "itemRotation"; value: 0 }
    PathLine { x: 100; y: 100 }
    PathAttribute { name: "itemRotation"; value: 90 }
}

In unserem Delegaten können wir dann die Rotationseigenschaft an die Attached Property PathView.itemRotation binden, die für dieses Attribut erstellt wurde.

Rectangle {
    width: 10; height: 10
    rotation: PathView.itemRotation
}

Wenn jedes Element entlang des Pfades positioniert wird, wird es entsprechend gedreht: Ein Element am Anfang des Pfades wird nicht gedreht, ein Element am Ende des Pfades wird um 90 Grad gedreht, und ein Element in der Mitte des Pfades wird um 45 Grad gedreht.

© 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.