EllipseShape QML Type
楕円、円弧、パイスライスをレンダリングできるシェイプコンポーネント。詳細...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| Since: | QtQuick 6.10 |
プロパティ
- borderMode : enumeration
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- fillRule : enumeration
- innerArcRatio : real
- joinStyle : enumeration
- startAngle : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
- sweepAngle : real
詳しい説明
EllipseShape アイテムは楕円を描画し、完全な楕円、円弧、または塗りつぶされたパイスライスとして表示されるようにカスタマイズできます。その外観は、startAngle とsweepAngle プロパティによって制御されます。
基本楕円
デフォルトでは、アイテムは完全な楕円を描画します。内部はfillColor で塗りつぶされ、輪郭はstrokeColor,strokeWidth,strokeStyle プロパティに従って描画されます。
円弧とパイスライス
円弧またはパイスライスを作成するには、startAngle (0-360 度) とsweepAngle (0-360 度) を設定して、描画する楕円のセグメントを定義します。
円弧モード:単純な円弧(輪郭のみ)を作成するには、fillColor を"transparent" に設定します。円弧のラインスタイルはdashPattern とdashOffset でカスタマイズできます。
パイモード:塗りつぶされたパイ・スライス(中心に接続されたセグメント)を作成するには、fillColor を設定するだけです。スライスのアウトラインもストロークされます。
ドーナツ・モード:ドーナツ・リング(中空の楕円)を作成するには、innerArcRatio を 0.0 から 1.0 の間の値に設定します。これは内側の楕円の半径と外側の楕円の半径の比率を定義します。
ストロークの内側の領域は、fillColor プロパティで指定された塗りつぶし色か、ShapeGradient サブタイプのいずれかを使用して定義され、fillGradient プロパティで設定されたグラデーションのいずれかを使用して描かれます。色とグラデーションの両方が指定された場合は、グラデーションが使用されます。
strokeColor 、strokeWidth プロパティを設定することで、楕円に独自の色と太さの境界線を追加することができます。色をtransparent に設定すると、塗りつぶし色のない枠線が作成されます。
楕円は、cornerRadius プロパティを使って角を丸くして描くことができます。cornerRadius のデフォルト値は 10 度です。
EllipseShape のQtQuick.Shapes::Shape::preferredRendererType のデフォルト値はShape.CurveRenderer です。
使用例
EllipseShape { id: ellipseShape anchors.fill: parent width: 90 height: 90 startAngle: 0 sweepAngle: 270 }

プロパティのドキュメント
borderMode : enumeration
borderMode プロパティは、楕円の縁に沿って境界線が描かれる場所を決定します。
| 定数 | 説明 |
|---|---|
EllipseShape.Inside | ボーダーはアイテムの内側の辺に沿って描かれ、アイテムの幅には影響しません。 |
これはデフォルト値です。
| 定数 | 説明 |
|---|---|
EllipseShape.Middle | ボーダーはアイテムの端に描かれ、アイテムの幅には影響しません。 |
EllipseShape.Outside | ボーダーはアイテムの外側の縁に沿って描かれ、アイテムの幅をstrokeWidth の値だけ大きくします。 |
strokeWidthも参照してください 。
capStyle : enumeration
このプロパティは、線の端点がどのように描かれるかを定義します。デフォルト値はShapePath.SquareCap です。
| 定数 | 説明 |
|---|---|
ShapePath.FlatCap | 線の終点を覆わない正方形の線端。 |
ShapePath.SquareCap | 終点を覆い、そこから線幅の半分だけはみ出る正方形の線端。 |
ShapePath.RoundCap | 丸みを帯びた線端。 |
cornerRadius : real
放射状の線が楕円弧に接する角の丸みを制御します。パイセグメントの場合、これは外側の円弧への接続を丸めます。ドーナツセグメントの場合、これは内側と外側の両方の円弧への接続も丸めます。
デフォルト値は10 です。
dashOffset : real
このプロパティは、ダッシュパターンを指定するために使用される単位で測定される、ダッシュパターン上の開始点を定義する。
デフォルト値は0 。
QPen::setDashOffset()も参照 。
dashPattern : list<real>
このプロパティは、strokeStyle がShapePath.DashLine に設定されているときのダッシュパターンを定義します。パターンは偶数の正の数で指定する必要があり、1, 3, 5...はダッシュ、2, 4, 6...はスペースです。パターンはペンの幅の単位で指定する。
デフォルト値は(4, 2)で、4 *strokeWidth ピクセルのダッシュと、2 *strokeWidth ピクセルのスペースを意味する。
QPen::setDashPattern()も参照のこと 。
fillColor : color
このプロパティは塗りつぶし色を保持する。
transparent に設定すると、塗りつぶしは行われない。
デフォルト値は"white" です。
注意: fillGradient のいずれかがnull 以外に設定されている場合、fillColor の代わりに使用されます。
fillGradient : ShapeGradient
楕円の塗りつぶし色のfillGradient。
デフォルトでは fillGradient は有効になっておらず、値は null です。こ の場合、 塗 り はfillColor の値に基づ く 塗 り 色を用います。
設定すると、fillColor は無視され、ShapeGradient のサブタイプのいずれかを使って塗りつぶしが行われます。
注: Gradient 型はここでは使用できません。むしろ、LinearGradient のような高度なサブタイプを使用することをお勧めします。
fillRule : enumeration
このプロパティは塗りつぶしルールを保持する。デフォルト値はShapePath.OddEvenFill である。塗りつぶしルールの説明については、QPainterPath::setFillRule() を参照してください。
| 定数 | 説明 |
|---|---|
ShapePath.OddEvenFill | 奇偶塗り潰し規則。 |
ShapePath.WindingFill | 非ゼロ巻線塗りつぶしルール。 |
innerArcRatio : real
このプロパティは、内側の円弧と外側の円弧の比率を定義する。
値の範囲は 0.0 から 1.0 です。値を0.0に設定すると、内側の円弧は中心に向かってつぶれ、塗りつぶされた楕円が描かれます。値を 1.0 に設定すると、内側の円弧は外側の楕円と同じ大きさになり、ただの円弧になります。0.0から1.0の間の値は、中空の楕円の輪を作成します。
デフォルト値は0 。
joinStyle : enumeration
このプロパティは、2つの接続線間の結合がどのように描画されるかを定義します。デフォルト値はShapePath.BevelJoin です。
| 定数 | 説明 |
|---|---|
ShapePath.MiterJoin | 線の外縁は角度をもって接するように延長され、この領域は塗りつぶされる。 |
ShapePath.BevelJoin | 2本の線の間の三角形の切り欠きが塗りつぶされます。 |
ShapePath.RoundJoin | 2本の線の間の円弧が塗りつぶされます。 |
startAngle : real
このプロパティは、楕円の描画を開始する角度を度単位で定義します。
0度は頂上を指します。角度は時計回りに増加します。
デフォルト値は0 です。
strokeColor : color
このプロパティはストロキングカラーを保持する。
transparent に設定する と 、 描線は行われない。
デフォル ト 値は"black" です。
strokeStyle : enumeration
このプロパティはストロークのスタイルを定義します。デフォルト値はShapePath.SolidLine です。
| 定数 | 説明 |
|---|---|
ShapePath.SolidLine | 無地の線。 |
ShapePath.DashLine | 数ピクセルで区切られたダッシュ。 |
strokeWidth : real
このプロパティはストローク幅を保持する。
負の値を設定すると、ストロークは発生しません。
デフォルト値は1 です。
sweepAngle : real
startAngle から描かれる角度の範囲を度単位で指定する。
正の値に設定すると、円弧は時計回りに描かれる。負の値を設定する と 、 円弧は反時計回 り に描かれます。
デフォルト値は360 。
© 2026 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.