RegularPolygonShape QML Type
塗りつぶされた正多角形で、必要に応じて枠線を追加できます。詳細...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| Since: | QtQuick 6.10 |
プロパティ
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- joinStyle : enumeration
- sideCount : int
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
詳細な説明
正多角形は、2次元の多角形形状のストローク、塗りつぶし、またはストロークと塗りつぶしの組み合わせのいずれかです。strokeColor 、strokeWidth 、およびstrokeStyle プロパティは、輪郭の外観を指定します。dashPattern およびdashOffset プロパティは、破線ストロークの外観を指定します。
ストロークの内側の領域は、fillColor プロパティで指定された単色の塗りつぶし色、またはShapeGradient のサブタイプの一つで定義され、gradientプロパティで設定されたグラデーションのいずれかを使用して塗りつぶされます。色とグラデーションの両方が指定されている場合は、グラデーションが使用されます。
ストローク付きのポリゴンを作成するには、sideCount プロパティを3~100の間で設定し、strokeWidth プロパティを0より大きい値に設定します。strokeWidth プロパティは、ポリゴンのストロークの幅を指定します。sideCount のデフォルト値は6、strokeWidth のデフォルト値は4です。strokeWidth の値を負の値に設定すると、境界線が非表示になります。
cornerRadius プロパティは、ポリゴンの角を丸くするかどうかを指定します。
プロパティのドキュメント
capStyle : enumeration
このプロパティは、線の端点がどのように描画されるかを定義します。デフォルト値はShapePath.SquareCap です。
| 定数 | 説明 |
|---|---|
ShapePath.FlatCap | 線の端点を覆わない正方形の線端。 |
ShapePath.SquareCap | 線の端点を覆い、線の幅の半分だけ端点から突き出た四角い線の端。 |
ShapePath.RoundCap | 角が丸い線の端。 |
多角線が描画されるため、パスは線端点を持たないループを形成します。したがって、capStyle が必要となるのは、strokeStyle ==ShapePath の場合のみです。DashLine
cornerRadius : real
「property」プロパティは、ポリゴンの頂点が丸みを帯びているかどうかを指定します。
デフォルト値は `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 などの高度なサブタイプのいずれかを使用することを推奨します。
joinStyle : enumeration
このプロパティは、2本の接続された線間の接合部の描画方法を定義します。デフォルト値は「ShapePath.BevelJoin 」です。
| 定数 | 説明 |
|---|---|
ShapePath.MiterJoin | 線の外側の端が角度をつけて延長され、その領域が塗りつぶされます。 |
ShapePath.BevelJoin | 2 本の線の間の三角形の切り欠き部分が塗りつぶされます。 |
ShapePath.RoundJoin | 2 本の線の間にある円弧が塗りつぶされます。 |
joinStyle は、cornerRadius == 0 の場合にのみ意味を持ちます。
sideCount : int
正多角形の辺の数。辺の最小数は3です。
デフォルト値は6 です。
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.