Back to Qt.io
Contact Us Blog Download Qt

PathArc QML Type

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

Import Statement: import QtQuick

プロパティ

詳細説明

PathArc は与えられた位置で終わり、指定された半径を使用する円弧を指定する簡単な方法を提供する。これは SVG の楕円弧コマンドに倣ったものである。

以下の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も参照して ください。

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

x : real

y : real

弧の終点を定義する。

relativeX およびrelativeYも参照 。


relativeX : real

relativeY : real

円弧の始点からの相対的な終点を定義する。

1つの軸に対して相対位置と絶対位置の両方の終了位置が指定されている場合は、相対位置が使用される。

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

x およびyも参照 。


radiusX : real

radiusY : real

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

以下の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
    }
}

direction : enumeration

弧の方向を定義します。指定可能な値はPathArc.Clockwise (デフォルト) とPathArc.Counterclockwise です。

以下のQMLでは、directionの値を変えることで、下図の2つの円弧のどちらかを作ることができます。

Path {
    startX: 50; startY: 50

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

useLargeArcも参照して ください。


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です。


xAxisRotation : real

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

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

注意： この値はXとYの半径が異なる場合にのみ有効で、円弧が楕円の断面であることを意味します。

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

Path {
    startX: 50; startY: 100

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

© 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.