EllipseShape QML Type

타원, 호 또는 파이 조각을 렌더링할 수 있는 도형 구성 요소입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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

상세 설명

EllipseShape 항목은 타원을 그립니다. 이 타원은 전체 타원, 호, 또는 채워진 파이 조각 형태로 표시되도록 사용자 정의할 수 있습니다. 그 모양은 ` 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도입니다.

EllipseShape의 QtQuick.Shapes::Shape::preferredRendererType 속성에 대한 기본값은 Shape.CurveRenderer 입니다.

사용 예

    EllipseShape {
        id: ellipseShape
        anchors.fill: parent
        width: 90
        height: 90
        startAngle: 0
        sweepAngle: 270
    }

속성 설명

borderMode : enumeration

borderMode 속성은 타원의 가장자리를 따라 테두리가 그려지는 위치를 결정합니다.

이것이 기본값입니다.

strokeWidth도 참조하십시오 .

capStyle : enumeration

이 속성은 선의 끝점이 어떻게 그려지는지를 정의합니다. 기본값은 ‘ ShapePath.SquareCap ’입니다.

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 : ShapeGradient

타원 채우기 색상의 fillGradient.

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

설정된 경우, ` fillColor `는 무시되며 ` ShapeGradient ` 하위 유형 중 하나를 사용하여 채우기가 수행됩니다.

fillRule : enumeration

이 속성은 채우기 규칙을 지정합니다. 기본값은 ShapePath.OddEvenFill 입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()을 참조하십시오.

innerArcRatio : real

이 속성은 안쪽 호와 바깥쪽 호의 비율을 정의합니다.

값의 범위는 0.0에서 1.0 사이입니다. 값을 0.0으로 설정하면 내부 호가 중심 쪽으로 접혀 들어가 채워진 타원이 그려집니다. 값을 1.0으로 설정하면 내부 호가 외부 타원과 같은 크기가 되어 단순히 호만 그려집니다. 0.0과 1.0 사이의 값을 설정하면 속이 빈 타원형 고리가 생성됩니다.

기본값은 0 입니다.

joinStyle : enumeration

이 속성은 두 개의 연결된 선 사이의 연결선을 어떻게 그릴지 정의합니다. 기본값은 ‘ ShapePath.BevelJoin ’입니다.

startAngle : real

이 속성은 타원 그리기를 시작할 시작 각도(도 단위)를 정의합니다.

0도는 위쪽을 가리킵니다. 각도는 시계 방향으로 증가합니다.

기본값은 0 입니다.

strokeColor : color

이 속성은 획 색상을 지정합니다.

transparent 로 설정하면 윤곽선이 표시되지 않습니다.

기본값은 ` "black"`입니다.

strokeStyle : enumeration

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

strokeWidth : real

이 속성은 획의 너비를 지정합니다.

음수 값으로 설정하면 획이 그려지지 않습니다.

기본값은 1 입니다.

sweepAngle : real

startAngle 에서 그려질 각도(도)입니다.

양수 값으로 설정하면 호가 시계 방향으로 그려집니다. 음수 값으로 설정하면 호가 반시계 방향으로 그려집니다.

기본값은 360 입니다.