このページでは

RectangleShape QML Type

塗りつぶされた長方形。オプションで枠線を設定できます。詳細...

Import Statement: import QtQuick.Shapes.DesignHelpers 6.12
Since: QtQuick 6.10

プロパティ

詳細な説明

RectangleShapeは、領域を単色またはグラデーションで塗りつぶしたり、長方形の枠線を追加したりするために使用されます。

各 Rectangle アイテムは、fillColor プロパティで指定された単色、またはShapeGradient のサブタイプのいずれかを使用して定義され、gradientプロパティで設定されたグラデーションのいずれかを使用して描画されます。色とグラデーションの両方が指定された場合は、グラデーションが使用されます。

strokeColor およびstrokeWidth プロパティを設定することで、独自の色と太さを持つ境界線を矩形に追加することができます。色をtransparent に設定すると、塗りつぶし色のない境界線が作成されます。

radius プロパティを使用すると、角が丸い長方形を描画できます。各角ごとに半径を個別に指定することも可能です。さらに、bevel を任意の角に適用することで、その角を鋭く切り落とすことができます。

RectangleShapeのQtQuick.Shapes::Shape::preferredRendererType のデフォルト値はShape.CurveRenderer です。

使用例

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

角が面取りされた緑色の長方形

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

bevel : bool

このプロパティは、矩形の角を面取りするかどうかを指定します。

これを `false ` に設定すると、個々の `radius ` プロパティの値に応じて、角がシャープになるか丸くなるかが決まります。

このプロパティは、個々のベベルプロパティによって上書きされる場合があります。

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

左上と右下の角が面取りされた長方形

「 topLeftBevel 」、「topRightBevel 」、「bottomLeftBevel 」、および「bottomRightBevel 」も参照してください 。

borderMode : enumeration

borderMode プロパティは、矩形の縁に沿って境界線がどこに描画されるかを決定します。

定数説明
RectangleShape.Inside境界線は項目の内側の縁に沿って描画され、項目の幅には影響しません。

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

定数説明
RectangleShape.Middle境界線は項目の端の上に描画され、項目の幅には影響しません。
RectangleShape.Outside境界線は項目の外側の縁に沿って描画され、項目の幅は `strokeWidth` の値だけ増加します。

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

bottomLeftBevel : bool

bottomRightBevel : bool

topLeftBevel : bool

topRightBevel : bool

これらのプロパティを設定すると、個々の角のベベルを定義します。これらをfalse に設定すると、個々のradius プロパティの値に応じて、角がシャープになるか丸みを帯びた状態になります。これらをtrue に設定すると、角にベベルが適用されます。設定されていない場合は、代わりにbevel の値が使用されます。

これらのプロパティは、デフォルトでは設定されていません。undefined を割り当てることで、設定されていない状態に戻すことができます。

次の例では、bottomRightBevel が true に設定されています:

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

3つの角が丸く、1つの角が面取りされた長方形の輪郭

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

bottomLeftRadius : real

bottomRightRadius : real

topLeftRadius : real

topRightRadius : real

これらのプロパティを設定すると、個々の角の半径を定義できます。値が 0 の場合はその角が鋭角となり、正の値の場合は丸みを帯びた角となります。設定されていない場合は、代わりに `radius ` の値が使用されます。

これらのプロパティはデフォルトでは設定されていません。undefined をこれらのプロパティに割り当てることで、設定されていない状態に戻すことができます。

次の例では、radius に `10` を、topLeftRadius に `0` を設定しています。

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

3つの角が丸く、1つの角が面取りされた長方形の輪郭

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

capStyle : enumeration

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

定数説明
ShapePath.FlatCap線の端点を覆わない正方形の線端。
ShapePath.SquareCap線の終点を覆い、線の幅の半分だけその先まで伸びた角型の線の端。
ShapePath.RoundCap角が丸い線の端。

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()も参照してください 。

drawBottom : bool [since 6.11]

このプロパティは、下側の境界線が描画されるかどうかを指定します。

デフォルト値はtrue です。

このプロパティは Qt 6.11 で導入されました。

drawLeft : bool [since 6.11]

このプロパティは、左側の境界線が描画されるかどうかを指定します。

デフォルト値はtrue です。

このプロパティはQt 6.11で導入されました。

drawRight : bool [since 6.11]

このプロパティは、右側の境界線が描画されるかどうかを指定します。

デフォルト値はtrue です。

このプロパティは Qt 6.11 で導入されました。

drawTop : bool [since 6.11]

このプロパティは、上部の境界線が描画されるかどうかを指定します。

デフォルト値はtrue です。

このプロパティはQt 6.11で導入されました。

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ゼロ以外のワインディング塗りつぶしルール。

joinStyle : enumeration

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

定数説明
ShapePath.MiterJoin線の外側の端が角度をつけて延長され、その部分が塗りつぶされます。
ShapePath.BevelJoin2 本の線の間の三角形の切り欠き部分が塗りつぶされます。
ShapePath.RoundJoin2 本の線間の円弧部分が塗りつぶされます。

radius : real

このプロパティは、角が丸い長方形を定義するために使用される角の半径を指定します。

radius が正の値の場合、矩形のパスは角丸矩形として定義され、そうでない場合は通常の矩形として定義されます。

このプロパティは、個々の角の半径プロパティによって上書きされる場合があります。

デフォルト値は `10` です。

関連項目: topLeftRadius 、topRightRadius 、bottomLeftRadius 、およびbottomRightRadius 。

strokeColor : color

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

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

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

strokeStyle : enumeration

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

定数説明
ShapePath.SolidLine実線。
ShapePath.DashLine数ピクセル間隔で区切られたダッシュ。

strokeWidth : real

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

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

デフォルト値は1 です。

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