Path QML Type

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

Import Statement: import QtQuick
Inherited By:

ShapePath

プロパティ

メソッド

詳細説明

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

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


©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。