ShapePath QML Type

This property defines how the end points of lines are drawn. The default value is ShapePath.SquareCap.

This property defines the starting point on the dash pattern, measured in units used to specify the dash pattern.

The default value is 0.

See also QPen::setDashOffset().

This property defines the dash pattern when ShapePath.strokeStyle is set to ShapePath.DashLine. The pattern must be specified as an even number of positive entries where the entries 1, 3, 5... are the dashes and 2, 4, 6... are the spaces. The pattern is specified in units of the pen's width.

The default value is (4, 2), meaning a dash of 4 * ShapePath.strokeWidth pixels followed by a space of 2 * ShapePath.strokeWidth pixels.

See also QPen::setDashPattern().

This property holds the fill color.

When set to transparent, no filling occurs.

The default value is white.

This property defines the fill gradient. By default no gradient is enabled and the value is null. In this case the fill will either be based on the fillItem property if it is set, and otherwise the fillColor property will be used.

This property defines another Qt Quick Item to use as fill by the shape. The item must be texture provider (such as a layered item, a ShaderEffectSource or an Image). If it is not a valid texture provider, this property will be ignored.

The visual parent of fillItem must be a Qt Quick Item. In particular, since ShapePath is not an Item, its children cannot be used as fill items. Manually setting the fillItem's parent is needed when it is created as a child of the ShapePath.

For instance, creating an Image object directly in the fillItem property assignment will make it a child of the ShapePath. In this case, its parent must be set manually. In the following example we use the window's contentItem as the parent.

fillItem: Image {
    visible: false
    source: "contents.png"
    parent: window.contentItem
}

By default no fill item is set and the value is null.

This property was introduced in Qt 6.8.

This property holds the fill rule. The default value is ShapePath.OddEvenFill. For an explanation on fill rules, see QPainterPath::setFillRule().

This property defines a transform to be applied to the path's fill pattern (fillGradient or fillItem). It has no effect if the fill is a solid color or transparent. By default no fill transform is enabled and the value of this property is the identity matrix.

This example displays a rectangle filled with the contents of myImageItem rotated 45 degrees around the center point of myShape:

ShapePath {
    fillItem: myImageItem
    fillTransform: PlanarTransform.fromRotate(45, myShape.width / 2, myShape.height / 2)
    PathRectangle { x: 10; y: 10; width: myShape.width - 20; height: myShape.height - 20 }
}

This property was introduced in Qt 6.8.

This property defines how joins between two connected lines are drawn. The default value is ShapePath.BevelJoin.

When joinStyle is set to ShapePath.MiterJoin, this property specifies how far the miter join can extend from the join point.

The default value is 2.

This property describes characteristics of the shape. If set, these hints may allow optimized rendering. By default, no hints are set. It can be a combination of the following values:

Not all hints are logically independent, but the dependencies are not enforced. For example, PathLinear implies PathQuadratic, but it is valid to have PathLinear without PathQuadratic.

The pathHints property describes a set of statements known to be true; the absence of a hint does not necessarily mean that the corresponding statement is false.

This property was introduced in Qt 6.7.

This property holds the stroking color.

When set to transparent, no stroking occurs.

The default value is white.

This property defines the style of stroking. The default value is ShapePath.SolidLine.

This property holds the stroke width.

When set to a negative value, no stroking occurs.

The default value is 1.