Back to Qt.io
Contact Us Blog Download Qt

PathArc QML Type

以给定的半径定义弧线。更多

Import Statement: import QtQuick

属性

详细说明

PathArc 提供了一种指定弧线的简单方法，该弧线在给定位置结束并使用指定的半径。它仿效 SVG 椭圆弧命令。

下面的 QML 生成了下图所示的路径：

Path {
    startX: 100; startY: 0

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

请注意，单个 PathArc 不能用于指定圆。您可以使用两个 PathArc 元素，每个元素指定半个圆。

另请参阅 Path,PathLine,PathQuad,PathCubic,PathAngleArc,PathCurve 和PathSvg 。

属性文档

x : real

y : real

定义弧线的终点。

另请参阅 relativeX 和relativeY 。


relativeX : real

relativeY : real

定义圆弧相对于其起点的终点。

如果同时为一个轴指定了相对和绝对的终点位置，则将使用相对位置。

相对位置和绝对位置可以混合使用，例如可以设置相对 x 和绝对 y。

另请参阅 x 和y 。


radiusX : real

radiusY : real

定义圆弧的半径。

下面的 QML 演示了如何使用不同的半径值来改变圆弧的形状：

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

direction : enumeration

定义圆弧的方向。可能的值是PathArc.顺时针（默认）和PathArc.逆时针。

下面的 QML 可以通过改变方向值生成下面两个图示弧线中的任何一个。

Path {
    startX: 50; startY: 50

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

另请参阅 useLargeArc 。


useLargeArc : bool

是否使用由圆弧点定义的大圆弧。

给定固定的起点和终点位置、半径和方向后，有两种可能的弧线适合数据。例如，下面的 QML 可以通过更改 useLargeArc 的值生成下面两个图示圆弧中的任何一个。

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

默认值是 false。


xAxisRotation : real

定义弧的旋转角度，单位为度。默认值为 0。

弧是圆或椭圆的一段。给定半径和起点和终点后，就会有两个椭圆连接这两个点。该属性定义了这些椭圆的 X 轴的旋转。

注： 该值只有在 x 和 y 半径不同时才有用，这意味着弧是椭圆的一段。

下面的 QML 演示了如何使用不同的半径值来改变弧的形状：

Path {
    startX: 50; startY: 100

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

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