RectangleShape QML Type

테두리가 있는 채워진 직사각형(선택 사항)입니다. 더 보기...

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

속성

상세 설명

RectangleShape는 단색 또는 그라데이션으로 영역을 채우고 직사각형 테두리를 제공하는 데 사용됩니다.

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

strokeColorstrokeWidth 속성을 설정하여 사각형에 고유한 색상과 두께로 테두리를 추가할 수 있습니다. 색상을 transparent 으로 설정하면 채우기 색상이 없는 테두리가 생성됩니다.

radius 속성을 사용하여 둥근 직사각형을 그릴 수 있습니다. 반경은 각 모서리에 대해 별도로 지정할 수도 있습니다. 또한 bevel 을 모서리에 적용하여 날카롭게 잘라낼 수 있습니다.

선호 렌더러 유형의 기본값은 Shape.CurveRenderer 입니다.

사용 예시

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

속성 문서

bottomLeftRadius : real

bottomRightRadius : real

topLeftRadius : real

topRightRadius : real

이 속성을 설정하면 개별 모서리 반경을 정의합니다. 0 값은 모서리를 날카롭게 정의하고 양수 값은 모서리를 둥글게 정의합니다. 설정하지 않으면 radius 값이 대신 사용됩니다.

이러한 속성은 기본적으로 설정되지 않습니다. 설정 해제 상태로 되돌리려면 undefined 을 지정하세요.

다음 예제에서 radius10 로, topLeftRadius0 로 설정되어 있습니다:

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

radius참조하세요 .


bottomLeftBevel : bool

bottomRightBevel : bool

topLeftBevel : bool

topRightBevel : bool

설정된 경우 이 속성은 개별 모서리 경사를 정의합니다. false 로 설정하면 개별 radius 속성의 값에 따라 모서리가 날카롭거나 둥글게 됩니다. true 로 설정하면 모서리가 경사진 모서리가 됩니다. 설정하지 않으면 bevel 값이 대신 사용됩니다.

이러한 속성은 기본적으로 설정되지 않습니다. 설정 해제 상태로 되돌리려면 undefined 을 지정합니다.

다음 예에서는 bottomRightBevel 이 true로 설정되어 있습니다:

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

bevel참조하세요 .


bevel : bool

이 속성은 직사각형의 모서리가 기울어져 있는지 여부를 정의합니다.

false 로 설정하면 개별 radius 속성의 값에 따라 모서리가 날카롭거나 둥글게 됩니다.

이 속성은 개별 경사 속성에 의해 재정의될 수 있습니다.

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

topLeftBevel, topRightBevel, bottomLeftBevel, bottomRightBevel참조하세요 .


borderMode : enumeration

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

Constant설명
RectangleShape.Inside테두리는 항목의 안쪽 가장자리를 따라 그려지며 항목 너비에는 영향을 주지 않습니다.

이것이 기본값입니다.

Constant설명
RectangleShape.Middle테두리가 항목의 가장자리에 그려지며 항목 너비에 영향을 주지 않습니다.
RectangleShape.Outside테두리는 항목의 바깥쪽 가장자리를 따라 그려지며 strokeWidth 값만큼 항목 너비가 증가합니다.

strokeWidth참조하십시오 .


capStyle : enumeration

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

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

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입니다.

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

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

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


fillRule : enumeration

이 속성은 채우기 규칙을 보유합니다. 기본값은 ShapePath.OddEvenFill 입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()를 참조하세요.

Constant설명
ShapePath.OddEvenFill홀수 짝수 채우기 규칙.
ShapePath.WindingFill0이 아닌 와인딩 채우기 규칙입니다.

joinStyle : enumeration

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

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

radius : real

이 속성은 둥근 직사각형을 정의하는 데 사용되는 모서리 반경을 정의합니다.

반경이 양수 값이면 직사각형 경로가 둥근 직사각형으로 정의되고, 그렇지 않으면 일반 직사각형으로 정의됩니다.

이 속성은 개별 모서리 반경 속성에 의해 재정의될 수 있습니다.

기본값은 10 입니다.

topLeftRadius, topRightRadius, bottomLeftRadius, bottomRightRadius참조하세요 .


strokeColor : color

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

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

기본값은 "black" 입니다.


strokeStyle : enumeration

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

Constant설명
ShapePath.SolidLine일반 선입니다.
ShapePath.DashLine몇 픽셀로 구분된 대시.

strokeWidth : real

이 속성은 획 너비를 보유합니다.

음수 값으로 설정하면 스트로크가 발생하지 않습니다.

기본값은 1 입니다.


© 2025 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.