En esta página

Path QML Type

Define una ruta que utilizarán PathView y Shape. Más información...

Import Statement: import QtQuick
Inherited By:

ShapePath

Propiedades

Métodos

Descripción detallada

Una ruta se compone de uno o más segmentos de ruta: PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg.

El espaciado entre los elementos a lo largo de la ruta se puede ajustar mediante un objeto « PathPercent ».

PathAttribute Permite definir atributos con nombre y valores a lo largo del trazado.

El tipo «Path» y los demás tipos para especificar elementos de ruta se comparten entre PathView y Shape. La siguiente tabla ofrece una visión general de la aplicabilidad de los distintos elementos de ruta:

ElementoPathViewFormaForma, software
PathMoveN/ASíSí
PathLineSíSíSí
PathPolylineSíSíSí
PathMultilineSíSíSí
PathQuadSíSíSí
PathCubicSíSíSí
PathArcSíSíSí
PathAngleArcSíSíSí
PathSvgSíSíSí
PathRectangleSíSíSí
PathAttributeSíN/AN/A
PathPercentSíN/AN/A
PathCurveSíNoNo

Nota: «Path» es un tipo no visual; por sí solo no muestra nada. Para dibujar una ruta, utiliza Shape.

Véase también PathView, Shape, PathAttribute, PathPercent, PathLine, PathPolyline, PathMove, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg y PathRectangle.

Documentación de la propiedad

asynchronous : bool [since 6.9]

Cuando se establece en «true», la ruta se procesará de forma asíncrona. Se trata de una optimización para procesar la ruta solo una vez, una vez que se hayan ejecutado todos los métodos que puedan afectarla. Esto significa que, cuando se establece en « true », la ruta actualizada no estará disponible inmediatamente después de, por ejemplo, ajustar « startX », « scale » o añadir un elemento, sino solo una vez que se haya procesado el bucle de eventos de Qt. El valor por defecto es false.

Esta propiedad se introdujo en Qt 6.9.

closed : bool [read-only]

Esta propiedad se cumple independientemente de que el inicio y el final de la ruta sean idénticos.

pathElements : list<PathElement> [default read-only]

Esta propiedad contiene los objetos que componen la ruta.

Una ruta puede contener los siguientes objetos de ruta:

  • PathLine - una línea recta hasta una posición determinada.
  • PathPolyline - una polilínea especificada como una lista de coordenadas.
  • PathMultiline - una lista de polilíneas especificadas como una lista de listas de coordenadas.
  • PathQuad - una curva de Bézier cuadrática hasta una posición determinada con un punto de control.
  • PathCubic - una curva de Bézier cúbica hasta una posición determinada con dos puntos de control.
  • PathArc - un arco hasta una posición dada con un radio.
  • PathAngleArc - un arco especificado por el punto central, los radios y los ángulos.
  • PathSvg - una ruta especificada como una cadena de datos de ruta SVG.
  • PathRectangle - Un rectángulo con una posición y un tamaño determinados.
  • PathCurve - un punto en una curva de Catmull-Rom.
  • PathAttribute - Un atributo en una posición determinada de la ruta.
  • PathPercent - Una forma de distribuir elementos a lo largo de varios segmentos de la ruta.
    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 }
        }
    }

scale : size [since QtQuick 2.14]

Esta propiedad almacena el factor de escala de la ruta. El ancho y la altura de scale pueden ser diferentes, para lograr un escalado anisotrópico.

Nota: La configuración de esta propiedad no afectará al ancho del borde.

Esta propiedad se introdujo en QtQuick 2.14.

simplify : bool [since 6.6]

Cuando se establece en «true», la ruta se simplificará. Esto implica fusionar todas las subrutas que se cruzan, creando una ruta en la que no haya autocruzamientos. Las líneas paralelas consecutivas también se fusionarán. La ruta simplificada está pensada para utilizarse con ` ShapePath.OddEvenFill`. Las curvas Bézier pueden aplanarse hasta convertirse en segmentos de línea debido a la inestabilidad numérica que supone realizar intersecciones de curvas Bézier.

Esta propiedad se introdujo en Qt 6.6.

startX : real

startY : real

Estas propiedades contienen la posición inicial de la ruta.

Documentación del método

[since QtQuick 2.14] point pointAtPercent(real t)

Devuelve el punto situado en el porcentaje t de la trayectoria actual. El argumento t debe estar comprendido entre 0 y 1.

Nota: Al igual que otros métodos de porcentaje de QPainterPath, la medición porcentual no es lineal con respecto a la longitud si la ruta contiene curvas. Cuando hay curvas, el argumento de porcentaje se asigna al parámetro t de las ecuaciones de Bézier.

Este método se introdujo en QtQuick 2.14.

Véase también QPainterPath::pointAtPercent().

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