路径 QML 类型

定义路径以供 PathViewShape 使用。 更多...

导入声明import QtQuick
继承自

ShapePath

属性

方法

详细描述

路径由一个或多个路径段组成 - PathLinePathPolylinePathQuadPathCubicPathArcPathAngleArcPathCurvePathSvg

可以通过一个 PathPercent 对象调整沿路径的项目间距。

PathAttribute 允许在路径上定义带有值的命名属性。

路径和其他用于指定路径段类型在 PathViewShape 之间共享。以下表格提供了各种路径段适用的概述

元素PathViewShapeShape, software
PathMoveN/AYesYes
PathLineYesYesYes
PathPolylineYesYesYes
PathMultiLineYesYesYes
PathQuadYesYesYes
PathCubicYesYesYes
PathArcYesYesYes
PathAngleArcYesYesYes
PathSvgYesYesYes
PathAttributeYesN/AN/A
PathPercentYesN/AN/A
PathCurveYesNoNo

注意:路径是一个非可视化类型;它本身不显示任何内容。要绘制路径,请使用 Shape

参见以下内容 PathView形状路径属性路径百分比值路径线路径多段线路径移动路径二次贝塞尔曲线路径三次贝塞尔曲线路径弧角度路径弧路径曲线路径SVG

属性文档

startX : 实数

startY : 实数

这些属性保留了路径的起始位置。


closed : 布尔值 [只读]

此属性保留路径起始点和终点是否相同。


pathElements : 列表<路径元素> [默认]

此属性保留组成路径的对象。

路径可以包含以下路径对象

    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 : 尺寸 [自QtQuick 2.14起]

此属性保留路径的缩放因子。缩放的宽度和高度可以不同,以实现各向异性缩放。

注意: 设置此属性将不会影响边框宽度。

此属性自QtQuick 2.14引入。


simplify : 布尔值 [自6.6起]

当设置为true时,路径将被简化。这意味着合并所有相交的子路径,创建一个没有自相交的路径。连续的平行线也将合并。简化的路径旨在与 ShapePath.OddEvenFill 一起使用。由于贝塞尔曲线交点的数值不稳定性,贝塞尔曲线可能被展平为线段。

此属性自Qt 6.6引入。


方法文档

[自QtQuick 2.14起] pointAtPercent(实数 t)

返回当前路径百分比值 t 的点。参数 t 必须介于0和1之间。

注意:QPainterPath中的其他百分比方法类似,如果路径中存在曲线,百分比测量与长度不是线性关系。存在曲线时,百分比参数将被映射到贝塞尔方程的t参数。

此方法是在QtQuick 2.14中引入的。

另请参阅 QPainterPath::pointAtPercent()。


© 2024 Qt公司有限公司。本文件中包含的文档贡献属于各自所有者的版权。本文件中提供的文档是根据自由软件基金会发布的< plantas link="http://www.gnu.org/licenses/fdl.html" translate="no">GNU自由文档许可证第1.3版的条款许可使用的。Qt及其相关标志是芬兰及/或其他国家的Qt公司有限公司的< a href="https://doc.qt.ac.cn/qt/trademarks.html" translate="no">商标。所有其他商标均属于其各自所有者。