EllipseShape QML Type

楕円、円弧、または円グラフのスライスを描画できる形状コンポーネント。詳細...

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

プロパティ

• 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 プロパティは、楕円の縁に沿って境界線がどこに描画されるかを指定します。

これがデフォルト値です。

「strokeWidth」も参照してください 。

capStyle : enumeration

このプロパティは、線の端点がどのように描画されるかを定義します。デフォルト値はShapePath.SquareCap です。

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 : ShapeGradient

楕円の塗りつぶし色のfillGradient。

デフォルトでは、fillGradientは有効になっておらず、値はnullです。この場合、塗りつぶしにはfillColor の値に基づいた単色が使用されます。

設定されると、fillColor は無視され、ShapeGradient のサブタイプいずれかを使用して塗りつぶしが行われます。

fillRule : enumeration

このプロパティは塗りつぶしルールを指定します。デフォルト値は `ShapePath.OddEvenFill` です。塗りつぶしルールの詳細については、QPainterPath::setFillRule() を参照してください。

innerArcRatio : real

このプロパティは、内側の円弧と外側の円弧の比率を定義します。

値の範囲は 0.0 から 1.0 です。値を 0.0 に設定すると、内側の弧が中心に向かって収縮し、実線の楕円が描かれます。値を 1.0 に設定すると、内側の弧が外側の楕円と同じサイズになり、単なる弧になります。 0.0 から 1.0 までの値を設定すると、中空の楕円形のリングが作成されます。

デフォルト値は0 です。

joinStyle : enumeration

このプロパティは、2本の接続された線間の接合部の描画方法を定義します。デフォルト値はShapePath.BevelJoin です。

startAngle : real

このプロパティは、楕円の描画を開始する角度（度単位）を定義します。

0度は上方向を指します。角度は時計回りに増加します。

デフォルト値は0 です。

strokeColor : color

このプロパティは、ストロークの色を指定します。

transparent に設定すると、ストロークは適用されません。

デフォルト値は"black" です。

strokeStyle : enumeration

このプロパティは、線のスタイルを定義します。デフォルト値は `ShapePath.SolidLine` です。

strokeWidth : real

このプロパティは、ストロークの幅を指定します。

負の値に設定すると、ストロークは描画されません。

デフォルト値は1 です。

sweepAngle : real

startAngle から描画する角度（度単位）。

正の値に設定すると、円弧は時計回りに描画されます。負の値に設定すると、円弧は反時計回りに描画されます。

デフォルト値は360 です。