PathArc QML Type

指定された半径を持つ円弧を定義します。詳細...

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

プロパティ

• direction : enumeration
• radiusX : real
• radiusY : real
• relativeX : real
• relativeY : real
• useLargeArc : bool
• x : real
• xAxisRotation : real
• y : real

詳細な説明

PathArc を使用すると、指定された位置で終わり、指定された半径を持つ円弧を簡単に指定できます。これは、SVG の elliptical-arc コマンドをモデルにしています。

以下のQMLコードは、下図に示すパスを生成します：

Path {
    startX: 100; startY: 0

    PathArc {
        x: 0; y: 100
        radiusX: 100; radiusY: 100
        useLargeArc: true
    }
}

なお、1つのPathArcだけでは円を指定することはできません。その代わりに、2つのPathArc要素を使用し、それぞれが円の半分を指定するようにします。

関連項目： Path 、PathLine 、PathQuad 、PathCubic 、PathAngleArc 、PathCurve 、およびPathSvg 。

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

direction : enumeration

円弧の方向を指定します。指定可能な値は、PathArc.Clockwise（デフォルト）およびPathArc.Counterclockwiseです。

以下のQMLでは、directionの値を変更することで、下に示された2つの円弧のいずれかを作成できます。

Path {
    startX: 50; startY: 50

    PathArc {
        x: 150; y: 50
        radiusX: 75; radiusY: 50
    }
}

useLargeArcも参照してください 。

円弧の半径を定義します。

以下のQMLは、半径の値を変えることで円弧の形状をどのように変更できるかを示しています：

Path {
    startX: 0; startY: 100

    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 15
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 25
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 50
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 50; radiusY: 100
    }
}

円弧の始点に対する終点を定義します。

1つの軸に対して相対位置と絶対位置の両方が指定された場合、相対位置が使用されます。

相対位置と絶対位置を混在させることができます。たとえば、x 軸を相対位置、y 軸を絶対位置に設定することは有効です。

x およびyも参照してください 。

useLargeArc : bool

アークポイントで定義された大きなアークを使用するかどうか。

開始位置、終了位置、半径、方向が固定されている場合、データに適合する弧は2通りあります。useLargeArcは、これらを区別するために使用されます。たとえば、以下のQMLでは、useLargeArcの値を変更することで、下図に示す2つの弧のいずれかを生成できます。

Path {
    startX: 0; startY: 100
    PathArc {
        x: 100; y: 200
        radiusX: 100; radiusY: 100
        direction: PathArc.Clockwise
    }
}

デフォルト値は false です。

円弧の終点を指定します。

「 relativeX 」および「relativeY 」も参照してください 。

xAxisRotation : real

円弧の回転角度を度単位で指定します。デフォルト値は 0 です。

円弧とは、円または楕円の一部です。半径と始点・終点が与えられると、それらの点を結ぶ2つの楕円が存在します。このプロパティは、これらの楕円のX軸周りの回転を定義します。

以下のQMLは、異なる半径値を使用して弧の形状を変更する方法を示しています：

Path {
    startX: 50; startY: 100

    PathArc {
        x: 150; y: 100
        radiusX: 50; radiusY: 20
        xAxisRotation: 45
    }
}