Path QML Type

PathView およびShape で使用されるパスを定義します。詳細...

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

プロパティ

• asynchronous : bool (since 6.9)
• closed : bool
• pathElements : list<PathElement>
• scale : size (since QtQuick 2.14)
• simplify : bool (since 6.6)
• startX : real
• startY : real

方法

• point pointAtPercent(real t) (since QtQuick 2.14)

詳細な説明

パスは、1つ以上のパスセグメント（PathLine 、PathPolyline 、PathQuad 、PathCubic 、PathArc 、PathAngleArc 、PathCurve 、PathSvg ）で構成されます。

パス上の項目の間隔は、PathPercent オブジェクトを使用して調整できます。

PathAttribute これにより、パスに沿って値を持つ名前付き属性を定義できます。

パスおよびパス要素を指定するためのその他のタイプは、PathView とShape で共通して使用されます。以下の表は、さまざまなパス要素の適用範囲の概要を示しています。

関連項目： PathView 、Shape 、PathAttribute 、PathPercent 、PathLine 、PathPolyline 、PathMove 、PathQuad 、PathCubic 、PathArc 、PathAngleArc 、PathCurve 、PathSvg 、およびPathRectangle 。

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

asynchronous : bool [since 6.9]

true に設定すると、パスは非同期で処理されます。これは、パスに影響を与える可能性のあるすべてのメソッドの実行後に、パスを一度だけ処理するという最適化です。つまり、true に設定した場合、startX やscale の調整、あるいは要素の追加を行った直後には更新されたパスは利用できず、Qt のイベントループが処理されてから初めて利用可能になります。 デフォルト値はfalse です。

このプロパティは Qt 6.9 で導入されました。

closed : bool [read-only]

この性質は、パスの始点と終点が同一であるかどうかにかかわらず成り立ちます。

pathElements : list<PathElement> [default read-only]

このプロパティには、パスを構成するオブジェクトが格納されます。

パスには、以下のパスオブジェクトを含めることができます：

• PathLine - 指定された位置への直線。
• PathPolyline - 座標のリストとして指定されたポリライン。
• PathMultiline - 座標のリストのリストとして指定されたポリラインのリスト。
• PathQuad - 制御点を持つ、指定された位置への2次ベジェ曲線。
• PathCubic - 2つの制御点を持つ、指定された位置までの3次ベジェ曲線。
• PathArc - 半径を指定した、指定された位置までの円弧。
• PathAngleArc - 中心点、半径、および角度で指定された円弧。
• PathSvg - SVGパスデータ文字列として指定されたパス。
• PathRectangle - 指定された位置とサイズを持つ矩形
• PathCurve - キャットマル・ロム曲線上の点。
• PathAttribute - パス上の指定された位置にある属性。
• PathPercent - パスの各セグメントに沿って項目を配置する方法。

    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 : size [since QtQuick 2.14]

このプロパティは、パスの拡大縮小倍率を保持します。scale の幅と高さは異なる値に設定でき、これにより異方性スケーリングを実現できます。

このプロパティは QtQuick 2.14 で導入されました。

simplify : bool [since 6.6]

true に設定すると、パスが簡略化されます。これにより、交差するすべてのサブパスが結合され、自己交差のないパスが生成されます。また、連続する平行線も結合されます。 簡略化されたパスは、ShapePath.OddEvenFill と組み合わせて使用することを想定しています。ベジェ曲線の交差処理における数値的な不安定性により、ベジェ曲線が線分へと平坦化される場合があります。

このプロパティはQt 6.6で導入されました。

これらのプロパティは、パスの開始位置を保持します。

メソッドのドキュメント

[since QtQuick 2.14] point pointAtPercent(real t)

現在のパスのt のパーセンテージに位置する点を返します。引数t は0から1の間の値でなければなりません。

このメソッドは QtQuick 2.14 で導入されました。

QPainterPath::pointAtPercent()も参照してください 。