RectangleShape QML Type
테두리가 있는 채워진 직사각형(선택 사항)입니다. 더 보기...
Import Statement: | import QtQuick.Shapes.DesignHelpers 6.10 |
Since: | QtQuick 6.10 |
속성
- bevel : bool
- borderMode : enumeration
- bottomLeftBevel : bool
- bottomLeftRadius : real
- bottomRightBevel : bool
- bottomRightRadius : real
- capStyle : enumeration
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- fillRule : enumeration
- joinStyle : enumeration
- radius : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
- topLeftBevel : bool
- topLeftRadius : real
- topRightBevel : bool
- topRightRadius : real
상세 설명
RectangleShape는 단색 또는 그라데이션으로 영역을 채우고 직사각형 테두리를 제공하는 데 사용됩니다.
각 직사각형 항목은 fillColor 속성을 사용하여 지정된 단색 채우기 색상 또는 ShapeGradient 하위 유형 중 하나를 사용하여 정의하고 그라데이션 속성을 사용하여 설정한 그라데이션을 사용하여 페인트됩니다. 색상과 그라데이션이 모두 지정된 경우 그라데이션이 사용됩니다.
strokeColor 및 strokeWidth 속성을 설정하여 사각형에 고유한 색상과 두께로 테두리를 추가할 수 있습니다. 색상을 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 }
속성 문서
이 속성을 설정하면 개별 모서리 반경을 정의합니다. 0 값은 모서리를 날카롭게 정의하고 양수 값은 모서리를 둥글게 정의합니다. 설정하지 않으면 radius 값이 대신 사용됩니다.
이러한 속성은 기본적으로 설정되지 않습니다. 설정 해제 상태로 되돌리려면 undefined
을 지정하세요.
다음 예제에서 radius 는 10
로, topLeftRadius
는 0
로 설정되어 있습니다:
RectangleShape { id: rectangleShape anchors.centerIn: parent topLeftRadius: 0 bottomRightBevel: true joinStyle: ShapePath.MiterJoin }
radius 를참조하세요 .
설정된 경우 이 속성은 개별 모서리 경사를 정의합니다. 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 |
이 속성은 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 와 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.
fillRule : enumeration |
이 속성은 채우기 규칙을 보유합니다. 기본값은 ShapePath.OddEvenFill
입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()를 참조하세요.
Constant | 설명 |
---|---|
ShapePath.OddEvenFill | 홀수 짝수 채우기 규칙. |
ShapePath.WindingFill | 0이 아닌 와인딩 채우기 규칙입니다. |
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.