이 페이지에서

RegularPolygonShape QML Type

테두리 옵션이 있는 채워진 정다각형입니다. 더 보기...

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

속성

자세한 설명

일반 다각형은 2D 다각형 모양의 획, 채우기 또는 채우기가 있는 획일 수 있습니다. strokeColor , strokeWidth, strokeStyle 속성은 윤곽선의 모양을 지정합니다. dashPatterndashOffset 속성은 파선 획의 모양을 지정합니다.

획 안의 영역은 fillColor 속성을 사용하여 지정된 단색 채우기 색상 또는 ShapeGradient 하위 유형 중 하나를 사용하여 정의하고 그라데이션 속성을 사용하여 설정한 그라데이션을 사용하여 페인트됩니다. 색상과 그라데이션이 모두 지정된 경우 그라데이션이 사용됩니다.

획이 있는 다각형을 만들려면 sideCount 속성을 3~100 사이로 설정하고 strokeWidth 속성을 0보다 크게 설정합니다. strokeWidth 속성은 다각형 획의 너비를 지정합니다. 기본값 sideCount 값은 6이고 기본값 strokeWidth 값은 4입니다. strokeWidth 값을 음수 값으로 설정하면 테두리가 숨겨집니다.

cornerRadius 속성은 다각형 모서리를 둥글게 처리할지 여부를 지정합니다.

속성 문서

capStyle : enumeration

이 속성은 선의 끝점을 그리는 방법을 정의합니다. 기본값은 ShapePath.SquareCap 입니다.

Constant설명
ShapePath.FlatCap선의 끝점을 덮지 않는 정사각형 선 끝점입니다.
ShapePath.SquareCap선의 끝점을 덮고 그 너비의 절반만큼 연장되는 정사각형 선 끝입니다.
ShapePath.RoundCap둥근 선 끝점.

다각형이 그려지므로 경로가 선 끝점이 없는 루프를 형성합니다. 따라서 capStyle은 strokeStyle == ShapePath.DashLine인 경우에만 필요합니다.

cornerRadius : real

속성 속성은 다각형 모서리를 둥글게 할지를 지정합니다.

기본값은 10 입니다.

dashOffset : real

이 속성은 대시 패턴의 시작점을 정의하며, 대시 패턴을 지정하는 데 사용되는 단위로 측정합니다.

기본값은 0 입니다.

QPen::setDashOffset()도 참조하세요 .

dashPattern : list<real>

이 속성은 strokeStyleShapePath.DashLine으로 설정된 경우 대시 패턴을 정의합니다. 패턴은 1, 3, 5... 항목이 대시이고 2, 4, 6... 항목이 공백인 짝수 양의 항목으로 지정해야 합니다. 패턴은 펜 너비 단위로 지정됩니다.

기본값은 (4, 2)로, 4 * strokeWidth 픽셀의 대시 뒤에 2 * strokeWidth 픽셀의 공백을 의미합니다.

QPen::setDashPattern()도 참조하세요 .

fillColor : color

이 속성은 채우기 색상을 보유합니다.

transparent 로 설정하면 채우기가 발생하지 않습니다.

기본값은 "white" 입니다.

참고: fillGradientnull 이 아닌 다른 값으로 설정된 경우 fillColor 대신 사용됩니다.

fillGradient : ShapeGradient

다각형 채우기 색의 채우기 그라데이션입니다.

기본적으로 fillGradient는 활성화되지 않으며 값은 null입니다. 이 경우 채우기는 fillColor 값에 따라 단색을 사용합니다.

설정하면 fillColor 은 무시되고 ShapeGradient 하위 유형 중 하나를 사용하여 채우기가 수행됩니다.

참고: Gradient 유형은 여기에 사용할 수 없습니다. 대신 LinearGradient 와 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.

joinStyle : enumeration

이 속성은 연결된 두 선 사이의 조인 방법을 정의합니다. 기본값은 ShapePath.BevelJoin 입니다.

Constant설명
ShapePath.MiterJoin선의 바깥쪽 가장자리가 비스듬히 만나도록 확장되고 이 영역이 채워집니다.
ShapePath.BevelJoin두 선 사이의 삼각형 노치가 채워집니다.
ShapePath.RoundJoin두 선 사이의 원형 호가 채워집니다.

joinStyle은 cornerRadius == 0인 경우에만 의미가 있습니다.

sideCount : int

정다각형의 가장자리 수입니다. 최소 가장자리 수는 3개일 수 있습니다.

기본값은 6 입니다.

strokeColor : color

이 속성은 스트로킹 색상을 유지합니다.

transparent 로 설정하면 스트로킹이 발생하지 않습니다.

기본값은 "black" 입니다.

strokeStyle : enumeration

이 속성은 획의 스타일을 정의합니다. 기본값은 ShapePath.SolidLine입니다.

Constant설명
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.