Path QML Type

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

Import Statement: import QtQuick
Inherited By:

ShapePath

プロパティ

方法

詳細な説明

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

パ ス に沿っ た項目の間隔は、PathPercent オブジ ェ ク ト を通 じ て調整す る こ と がで き ます。

PathAttribute は、パスに沿って値を持つ名前付き属性を定義することができます。

パ ス と 、 パ ス要素を指定す る ためのその他の種別は、PathViewShape の間で共有 さ れてい ます。以下の表に、 さ ま ざ ま なパ ス要素の適用可能性の概観を示 し ます:

要素PathView形状形状、ソフトウェア
PathMove該当なし該当なし形状、ソフトウェア
PathLine形状、ソフトウェアはいあり
PathPolylineはいはいはい
PathMultilineはいはいはい
PathQuadはいはいはい
PathCubicはいはいはい
PathArcはいはいはい
PathAngleArcはいはいはい
PathSvgはいはいはい
PathRectangleはいはいはい
PathAttributeはい該当なし該当なし
PathPercentはい該当なし該当なし
PathCurveありなしなし

注: パスは非ビジュアルタイプであり、それ自体では何も表示しない。パスを描画するにはShape を使用する。

PathView,Shape,PathAttribute,PathPercent,PathLine,PathPolyline,PathMove,PathQuad,PathCubic,PathArc,PathAngleArc,PathCurve,PathSvg,PathRectangleも参照の こと。

プロパティ・ドキュメンテーション

startX : real

startY : real

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


closed : bool [read-only]

このプロパティは、パスの始点と終点が同一であるかどうかを保持する。


pathElements : list<PathElement> [default]

こ のプ ロ パテ ィ は、 パ ス を構成す る オブジ ェ ク ト を保持 し ます。

パ スは以下のパ ス オブジ ェ ク ト を含む こ と がで き ます:

  • 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 の間でなければならない。

注意: QPainterPath の他のパーセンテージメソッドと同様に、パスに曲線が存在する場合、パーセンテージ測定は長さに対して線形ではありません。曲線が存在する場合、パーセンテージの引数は Bezier 方程式のt パラメータにマップされます。

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

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


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.