En esta página

PathAttribute QML Type

Especifica cómo establecer un atributo en una posición determinada de una ruta. Más información...

Import Statement: import QtQuick

Propiedades

Descripción detallada

El objeto PathAttribute permite especificar atributos, compuestos por un nombre y un valor, para distintos puntos a lo largo de una ruta. Los atributos se exponen al delegado como propiedades adjuntas. El valor de un atributo en cualquier punto concreto de la ruta se interpola a partir de los PathAttributes que delimitan ese punto.

El ejemplo siguiente muestra una ruta en la que los elementos tienen una escala del 30 % y una opacidad del 50 % en la parte superior de la ruta, y una escala del 100 % y una opacidad del 100 % en la parte inferior. Obsérvese el uso de las propiedades adjuntas ` PathView.iconScale` e ` PathView.iconOpacity` para establecer la escala y la opacidad del delegado.

PathView en el que se muestran tres elementos con el logotipo de Qt y los nombres: «John Smith» y «Jane Doe», pequeños y difuminados en la parte superior, y «Bill Jones», grande y opaco en el centro

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 }
        }
    }
}

(Consulte la documentación de PathView para conocer la especificación de ContactModel.qml utilizada para el ContactModel anterior).

Véase también Path.

Documentación de propiedades

name : string

Esta propiedad contiene el nombre del atributo que se va a modificar.

Este atributo estará disponible para el delegado como PathView.<nombre>

Ten en cuenta que está permitido utilizar como atributo el nombre de una propiedad de elemento ya existente, como «opacity». Esto se debe a que los atributos de ruta añaden una nueva propiedad adjunta que no entra en conflicto en modo alguno con las propiedades existentes.

value : real

Esta propiedad contiene el valor del atributo.

El valor especificado se puede utilizar para influir en el aspecto visual de un elemento a lo largo de la ruta. Por ejemplo, la siguiente ruta especifica un atributo denominado «itemRotation», que tiene el valor 0 al principio de la ruta y el valor 90 al final de la misma.

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

En nuestro delegado, podemos entonces vincular la propiedad de rotación a la propiedad adjunta PathView.itemRotation creada para este atributo.

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

A medida que cada elemento se coloque a lo largo de la ruta, girará en consecuencia: un elemento situado al principio de la ruta no girará, uno situado al final girará 90 grados y uno situado a mitad de la ruta girará 45 grados.

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