ShapePath QML Type

パスおよび、そのパスに関連する線画と塗りつぶしのプロパティについて説明します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

列挙型

• CapStyle
• FillRule
• JoinStyle

プロパティ

• capStyle : CapStyle
• fillColor : color
• fillGradient : ShapeGradient (since Qt Quick Ultralite 2.7)
• fillRule : FillRule
• joinStyle : JoinRule
• miterLimit : int
• strokeColor : color
• strokeWidth : real

詳細な説明

Shape には、1つ以上のShapePath要素が含まれます。Shapeが可視的な出力を生成するには、少なくとも1つの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に関連付けた結果がこちらです：

「Qt Quick Ultralite shapes Example」および「Shape 」も参照してください 。

列挙型のドキュメント

CapStyle

改行コードに関するオプションの一覧を表示します。

FillRule

塗りつぶしルールのオプション一覧を表示します。

JoinStyle

結合スタイルのオプション一覧を表示します。

プロパティのドキュメント

capStyle : CapStyle [default]

このプロパティは、線の端点がどのように描画されるかを定義します。

fillColor : color

このプロパティは、塗りつぶしの色を指定します。

transparent に設定すると、塗りつぶしは行われません。

デフォルト値はwhite です。

fillGradient : ShapeGradient [since Qt Quick Ultralite 2.7]

このプロパティは、塗りつぶしのグラデーションを定義します。デフォルトではグラデーションは有効になっておらず、値は null です。この場合、塗りつぶしには `ShapePath.fillColor` の値に基づいた単色が使用されます。

設定されると、ShapePath.fillColor は無視され、ShapeGradient のサブタイプのいずれかを使用して塗りつぶしが行われます。

このプロパティは、Qt Quick Ultralite 2.7 で導入されました。

fillRule : FillRule [default]

このプロパティは塗りつぶしルールを保持します。塗りつぶしルールの詳細については、QPainterPath::setFillRule() を参照してください。

joinStyle : JoinRule [default]

このプロパティは、2本の接続された線間の接合部の描画方法を定義します。

miterLimit : int [default]

joinStyle が `ShapePath.MiterJoin` に設定されている場合、このプロパティは、マイター接合部が接合点からどの程度まで伸びることができるかを指定します。

strokeColor : color

このプロパティは、ストロークの色を指定します。

transparent に設定すると、ストロークは適用されません。

デフォルト値はwhite です。

strokeWidth : real

このプロパティは、ストロークの幅を指定します。

負の値に設定すると、ストロークは行われません。

デフォルト値は 1 です。

特定の Qt ライセンスで利用可能です。
詳細はこちらをご覧ください。