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)

詳細な説明

PathLine,PathPolyline,PathQuad,PathCubic,PathArc,PathAngleArc,PathCurve,PathSvg の1つまたは複数のパスセグメントで構成されます。

パ ス に沿っ た項目の間隔は、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 - Catmull-Rom 曲線上の点。
• 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()も参照してください 。