EllipseShape QML Type
타원, 호 또는 파이 슬라이스를 렌더링할 수 있는 도형 컴포넌트입니다. 더 보기...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| Since: | QtQuick 6.10 |
속성
- borderMode : enumeration
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- fillRule : enumeration
- innerArcRatio : real
- joinStyle : enumeration
- startAngle : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
- sweepAngle : real
상세 설명
타원 모양 항목은 전체 타원, 호 또는 채워진 파이 조각으로 표시되도록 사용자 지정할 수 있는 타원을 그립니다. 모양은 startAngle 및 sweepAngle 속성으로 제어됩니다.
기본 타원
기본적으로 항목은 전체 타원을 렌더링합니다. 내부는 fillColor 로 채워지고 strokeColor, strokeWidth, strokeStyle 속성에 따라 윤곽이 그려집니다.
호 및 파이 슬라이스
호 또는 파이 슬라이스를 만들려면 startAngle (0-360도) 및 sweepAngle (0-360도)를 설정하여 그릴 타원의 세그먼트를 정의합니다.
호 모드: 간단한 호(윤곽선만)를 만들려면 fillColor 을 "transparent" 으로 설정합니다. 호의 선 스타일은 dashPattern 및 dashOffset 으로 사용자 지정할 수 있습니다.
파이 모드: 채워진 파이 슬라이스(중앙에 연결된 세그먼트)를 만들려면 fillColor 을 설정하면 됩니다. 슬라이스의 윤곽선도 획으로 그려집니다.
도넛 모드: 도넛 링(속이 빈 타원)을 만들려면 innerArcRatio 을 0.0에서 1.0 사이의 값으로 설정합니다. 이 값은 안쪽 타원의 반지름과 바깥쪽 타원의 반지름의 비율을 정의합니다.
획 내부 영역은 fillColor 속성을 사용하여 지정한 단색 채우기 색상 또는 ShapeGradient 하위 유형 중 하나를 사용하여 정의하고 fillGradient 속성을 사용하여 설정한 그라데이션을 사용하여 페인트됩니다. 색상과 그라데이션이 모두 지정된 경우 그라데이션이 사용됩니다.
strokeColor 및 strokeWidth 속성을 설정하여 자체 색상과 두께로 타원에 선택적 테두리를 추가할 수 있습니다. 색상을 transparent 으로 설정하면 채우기 색상이 없는 테두리가 생성됩니다.
cornerRadius 속성을 사용하여 둥근 모서리로 타원을 그릴 수 있습니다. cornerRadius 의 기본값은 10도입니다.
QtQuick.Shapes::Shape::preferredRendererType 의 기본값은 Shape.CurveRenderer 입니다.
사용 예
EllipseShape { id: ellipseShape anchors.fill: parent width: 90 height: 90 startAngle: 0 sweepAngle: 270 }

속성 문서
borderMode : enumeration
borderMode 속성은 타원의 가장자리를 따라 테두리가 그려지는 위치를 결정합니다.
| 상수 | 설명 |
|---|---|
EllipseShape.Inside | 테두리는 항목의 안쪽 가장자리를 따라 그려지며 항목 너비에는 영향을 주지 않습니다. |
이것이 기본값입니다.
| Constant | 설명 |
|---|---|
EllipseShape.Middle | 테두리가 항목의 가장자리에 그려지며 항목 너비에 영향을 주지 않습니다. |
EllipseShape.Outside | 테두리는 항목의 바깥쪽 가장자리를 따라 그려지며 strokeWidth 값만큼 항목 너비가 증가합니다. |
strokeWidth 를참조하세요 .
capStyle : enumeration
이 속성은 선의 끝점을 그리는 방법을 정의합니다. 기본값은 ShapePath.SquareCap 입니다.
| Constant | 설명 |
|---|---|
ShapePath.FlatCap | 선의 끝점을 덮지 않는 정사각형 선 끝점입니다. |
ShapePath.SquareCap | 선의 끝점을 덮고 그 너비의 절반만큼 연장되는 정사각형 선 끝입니다. |
ShapePath.RoundCap | 둥근 선 끝. |
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는 활성화되지 않으며 값은 null입니다. 이 경우 채우기는 fillColor 값에 따라 단색을 사용합니다.
설정하면 fillColor 은 무시되고 ShapeGradient 하위 유형 중 하나를 사용하여 채우기가 수행됩니다.
참고: Gradient 유형은 여기에 사용할 수 없습니다. 대신 LinearGradient 와 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.
fillRule : enumeration
이 속성은 채우기 규칙을 보유합니다. 기본값은 ShapePath.OddEvenFill 입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()를 참조하세요.
| Constant | 설명 |
|---|---|
ShapePath.OddEvenFill | 홀수 짝수 채우기 규칙. |
ShapePath.WindingFill | 0이 아닌 와인딩 채우기 규칙입니다. |
innerArcRatio : real
이 속성은 내부 호와 외부 호 사이의 비율을 정의합니다.
값 범위는 0.0에서 1.0 사이입니다. 값을 0.0으로 설정하면 내부 호가 중앙을 향해 축소되어 단단하게 채워진 타원이 그려집니다. 값을 1.0으로 설정하면 내부 호가 외부 타원과 같은 크기가 되어 호만 그려집니다. 0.0에서 1.0 사이의 값은 속이 빈 타원형 고리를 만듭니다.
기본값은 0 입니다.
joinStyle : enumeration
이 속성은 연결된 두 선 사이의 조인 방법을 정의합니다. 기본값은 ShapePath.BevelJoin 입니다.
| Constant | 설명 |
|---|---|
ShapePath.MiterJoin | 선의 바깥쪽 가장자리가 비스듬히 만나도록 확장되고 이 영역이 채워집니다. |
ShapePath.BevelJoin | 두 선 사이의 삼각형 노치가 채워집니다. |
ShapePath.RoundJoin | 두 선 사이의 원형 호가 채워집니다. |
startAngle : real
이 속성은 타원을 그리기 시작할 시작 각도를 도 단위로 정의합니다.
0도는 위쪽을 가리킵니다. 각도는 시계 방향으로 증가합니다.
기본값은 0 입니다.
strokeColor : color
이 속성은 스트로킹 색상을 유지합니다.
transparent 로 설정하면 스트로킹이 발생하지 않습니다.
기본값은 "black" 입니다.
strokeStyle : enumeration
이 속성은 획의 스타일을 정의합니다. 기본값은 ShapePath.SolidLine입니다.
| Constant | 설명 |
|---|---|
ShapePath.SolidLine | 일반 선입니다. |
ShapePath.DashLine | 몇 픽셀로 구분된 대시. |
strokeWidth : real
이 속성은 획 너비를 보유합니다.
음수 값으로 설정하면 스트로크가 발생하지 않습니다.
기본값은 1 입니다.
sweepAngle : real
startAngle 에서 그릴 각도 범위(도)입니다.
양수 값으로 설정하면 호가 시계 방향으로 그려집니다. 음수 값으로 설정하면 호가 시계 반대 방향으로 그려집니다.
기본값은 360 입니다.
© 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.