RegularPolygonShape QML Type
塗りつぶされた正多角形で、境界線はオプションです。詳細...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| 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
詳細説明
正多角形は、単なる2D多角形のストローク、塗りつぶし、または塗りつぶし付きストロークになる。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
このプロパティは、ポリゴンの角を丸めるかどうかを指定します。
デフォルト値は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.