이 페이지에서

StarShape QML Type

테두리를 선택적으로 적용할 수 있는 채워진 별 모양의 다각형. 더 보기...

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

속성

상세 설명

별은 별 모양의 획, 채우기, 또는 획과 채우기가 결합된 형태일 수 있습니다. strokeColor, strokeWidth 및 strokeStyle 속성은 윤곽선의 모양을 지정합니다. dashPattern 및 dashOffset 속성은 점선 획의 모양을 지정합니다.

pointCount 속성을 3에서 60 사이로 설정하여 별의 꼭지점 수를 지정합니다. ratio 속성을 0.1에서 1 사이로 설정하여 별의 안쪽 꼭지점이 중심에서 떨어진 거리를 지정합니다.

선 안쪽 영역은 ‘ fillColor ’ 속성을 통해 지정된 단색 채우기 색상이나, ‘ ShapeGradient ’의 하위 유형 중 하나로 정의되고 ‘gradient’ 속성을 통해 설정된 그라데이션 중 하나로 채워집니다. 색상과 그라데이션이 모두 지정된 경우 그라데이션이 사용됩니다.

선(stroke)이 있는 별을 만들려면 ` strokeWidth ` 속성을 0보다 큰 값으로 설정하십시오. ` strokeWidth ` 속성은 다각형 선의 너비를 지정합니다. ` pointCount `의 기본값은 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

이 속성은 두 개의 연결된 선 사이의 접합부가 어떻게 그려지는지를 정의합니다. 기본값은 ‘ ShapePath.BevelJoin ’입니다.

상수설명
ShapePath.MiterJoin선의 바깥쪽 가장자리가 각도를 이루며 만나도록 연장되고, 이 영역이 채워집니다.
ShapePath.BevelJoin두 선 사이의 삼각형 모양의 홈이 채워집니다.
ShapePath.RoundJoin두 선 사이의 원호 부분이 채워집니다.

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

pointCount : int

이 속성은 별이 가진 총 점수를 정의합니다.

기본값은 6 입니다.

ratio : real

이 속성은 별의 내부 점들이 중심으로부터 떨어진 거리를 정의합니다.

기본값은 0.5 입니다.

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.