En esta página

PathArc QML Type

Define un arco con el radio dado. Más...

Import Statement: import QtQuick

Propiedades

Descripción detallada

PathArc proporciona una forma sencilla de especificar un arco que termina en una posición dada y utiliza el radio especificado. Está modelado a partir del comando de arco elíptico SVG.

El siguiente QML produce la trayectoria que se muestra a continuación:

Path {
    startX: 100; startY: 0

    PathArc {
        x: 0; y: 100
        radiusX: 100; radiusY: 100
        useLargeArc: true
    }
}

Tenga en cuenta que no se puede utilizar un único PathArc para especificar un círculo. En su lugar, puede utilizar dos elementos PathArc, cada uno de los cuales especificará la mitad del círculo.

Véase también Path, PathLine, PathQuad, PathCubic, PathAngleArc, PathCurve, y PathSvg.

Documentación de propiedades

direction : enumeration

Define la dirección del arco. Los valores posibles son PathArc.Clockwise (por defecto) y PathArc.Counterclockwise.

El siguiente QML puede producir cualquiera de los dos arcos ilustrados a continuación cambiando el valor de la dirección.

Path {
    startX: 50; startY: 50

    PathArc {
        x: 150; y: 50
        radiusX: 75; radiusY: 50
    }
}

Véase también useLargeArc.

radiusX : real

radiusY : real

Define el radio del arco.

El siguiente QML demuestra cómo se pueden utilizar diferentes valores de radio para cambiar la forma del arco:

Path {
    startX: 0; startY: 100

    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 15
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 25
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 50
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 50; radiusY: 100
    }
}

relativeX : real

relativeY : real

Define el punto final del arco en relación con su inicio.

Si se especifica tanto una posición final relativa como absoluta para un mismo eje, se utilizará la posición relativa.

Las posiciones relativas y absolutas pueden mezclarse, por ejemplo es válido establecer una x relativa y una y absoluta.

Véase también x y y.

useLargeArc : bool

Si se utiliza un arco grande definido por los puntos del arco.

Dadas las posiciones inicial y final fijas, el radio y la dirección, hay dos posibles arcos que pueden ajustarse a los datos. useLargeArc se utiliza para distinguir entre ellos. Por ejemplo, el siguiente QML puede producir cualquiera de los dos arcos ilustrados a continuación cambiando el valor de useLargeArc.

Path {
    startX: 0; startY: 100
    PathArc {
        x: 100; y: 200
        radiusX: 100; radiusY: 100
        direction: PathArc.Clockwise
    }
}

El valor por defecto es false.

x : real

y : real

Define el punto final del arco.

Véase también relativeX y relativeY.

xAxisRotation : real

Define la rotación del arco, en grados. El valor por defecto es 0.

Un arco es una sección de círculos o elipses. Dado el radio y los puntos inicial y final, hay dos elipses que conectan los puntos. Esta propiedad define la rotación del eje X de estas elipses.

Nota: El valor sólo es útil cuando los radios x e y difieren, lo que significa que el arco es una sección de elipses.

El siguiente QML demuestra cómo se pueden utilizar diferentes valores de radio para cambiar la forma del arco:

Path {
    startX: 50; startY: 100

    PathArc {
        x: 150; y: 100
        radiusX: 50; radiusY: 20
        xAxisRotation: 45
    }
}

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