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 속성을 통해 설정된 그라데이션 중 하나로 채워집니다. 색상과 그라데이션이 모두 지정된 경우 그라데이션이 사용됩니다.
선(stroke)이 있는 다각형을 만들려면, 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
이 속성은 두 개의 연결된 선 사이의 접합부가 어떻게 그려지는지를 정의합니다. 기본값은 ‘ ShapePath.BevelJoin ’입니다.
| 상수 | 설명 |
|---|---|
ShapePath.MiterJoin | 선의 바깥쪽 가장자리가 각도를 이루며 만나도록 연장되고, 이 영역이 채워집니다. |
ShapePath.BevelJoin | 두 선 사이의 삼각형 모양의 홈이 채워집니다. |
ShapePath.RoundJoin | 두 선 사이의 원호 부분이 채워집니다. |
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.