C

ShapePath QML 类型

描述路径及其相关属性，如线条和填充。 更多...

导入语句import QtQuick.Shapes
自Qt Quick Ultralite 1.8
继承

Path

属性

详细描述

一个 Shape 包含一个或多个 ShapePath 元素。为了使 Shape 输出任何可见的内容，至少需要一个 ShapePath。ShapePath 自身是一个 Path，具有额外的属性来描述线条和填充参数，例如线条宽度、颜色、填充颜色或渐变、连接和圆角样式等。与普通的 Path 对象一样，ShapePath 也包含一组路径元素，如 PathMove、PathLine、PathCubic、PathQuad、PathArc，以及起始位置。

这些数据集中任何属性的变化都会向上传递并改变 Shape 的输出。这意味着使用常用的 QML 绑定和动画类型（如 NumberAnimation）轻松更改或甚至是动画起始位置、结束位置、控制点或任何线条或填充参数是简单且容易的。

以下示例中，线连接样式会根据 joinStyleIndex 的值自动更改

import QtQuick
import QtQuick.Shapes
Rectangle {
    width: 300
    height: 300
    Shape {
        width: 200
        height: 150
        ShapePath {
            strokeColor: "black"
            strokeWidth: 16
            fillColor: "transparent"
            capStyle: ShapePath.RoundCap
            joinStyle: ShapePath.RoundJoin
            startX: 30
            startY: 30
            PathLine { x: 100; y: 100 }
            PathLine { x: 30; y: 100 }
        }
    }
}

以下是与之关联的 Shape 的结果

注意： 要导入 QtQuick.Shapes，您必须将 Qul::Shapes 模块链接到您的项目中。有关更多信息，请参阅Qt Quick Ultralite Shapes QML 类型。

另请参阅 Qt Quick Ultralite shapes 示例 和 Shape。

属性文档

capStyle : 枚举

这个属性定义了线的端点如何绘制。默认值是 ShapePath.SquareCap。

常量描述
ShapePath.FlatCap一个不覆盖线端点的方形线端。
ShapePath.SquareCap一个覆盖线端点并将线宽一半延伸到线端外的方形线端。
ShapePath.RoundCap一个圆形线端。

fillColor : 颜色

该属性保存填充颜色。

当设置为 transparent 时，不会进行填充。

默认值是 白色。


[自 Qt Quick Ultralite 2.7 开始] fillGradient : ShapeGradient

这个属性定义了填充渐变。默认情况下没有启用渐变，值为 null。在这种情况下，填充使用基于 ShapePath.fillColor 值的纯色。

当设置时，会忽略 ShapePath.fillColor 并使用 ShapeGradient 的子类型之一进行填充。

注意：不能在此处使用 Gradient 基类型，必须使用 LinearGradient 子类型。

此属性是在 Qt Quick Ultralite 2.7 中引入的。


fillRule : 枚举

该属性保存填充规则。默认值是 ShapePath.OddEvenFill。关于填充规则的解释，请参阅 QPainterPath::setFillRule()。

常量描述
ShapePath.OddEvenFill奇偶填充规则。
ShapePath.WindingFill非零环绕填充规则。

joinStyle : 枚举

此属性定义了连接两条线的连接处如何绘制。默认值是 ShapePath.BevelJoin。

常量描述
ShapePath.MiterJoin将线条的外边缘延伸以在角处相遇，并填充该区域。
ShapePath.BevelJoin两条线之间的三角形凹槽被填充。
ShapePath.RoundJoin两条线之间的圆形圆弧被填充。

miterLimit : 整数

当 joinStyle 设置为 ShapePath.MiterJoin 时，此属性指定切线连接可以延伸多远。

默认值是 2。


strokeColor : 颜色

此属性保存绘制颜色。

当设置为 transparent 时，不会进行绘制。

默认值是 白色。


strokeWidth : 实数

此属性保存笔画宽度。

当设置为负值时，不会进行绘制。

默认值是 1。


在某些 Qt 许可下提供。
了解详情。