RectangleShape QML Type
테두리가 있을 수도 있고 없을 수도 있는 채워진 사각형. 더 보기...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| Since: | QtQuick 6.10 |
속성
- bevel : bool
- borderMode : enumeration
- bottomLeftBevel : bool
- bottomLeftRadius : real
- bottomRightBevel : bool
- bottomRightRadius : real
- capStyle : enumeration
- dashOffset : real
- dashPattern : list<real>
- drawBottom : bool
(since 6.11) - drawLeft : bool
(since 6.11) - drawRight : bool
(since 6.11) - drawTop : bool
(since 6.11) - 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는 영역을 단색이나 그라데이션으로 채우고 직사각형 테두리를 적용하는 데 사용됩니다.
각 Rectangle 항목은 ` fillColor ` 속성을 통해 지정된 단색 채우기 색상이나, ` ShapeGradient ` 하위 유형 중 하나로 정의되고 `gradient` 속성을 통해 설정된 그라데이션 중 하나를 사용하여 채워집니다. 색상과 그라데이션이 모두 지정된 경우, 그라데이션이 사용됩니다.
strokeColor 및 strokeWidth 속성을 설정하여 직사각형에 고유한 색상과 두께를 가진 테두리를 선택적으로 추가할 수 있습니다. 색상을 transparent 로 설정하면 채우기 색상이 없는 테두리가 생성됩니다.
radius 속성을 사용하여 모서리가 둥근 사각형을 그릴 수 있습니다. 각 모서리에 대해 반지름을 별도로 지정할 수도 있습니다. 또한, bevel 속성을 적용하여 모서리를 날카롭게 다듬을 수 있습니다.
RectangleShape의 QtQuick.Shapes::Shape::preferredRendererType 속성 기본값은 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
}
속성 설명서
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 속성은 사각형의 가장자리를 따라 테두리가 그려지는 위치를 결정합니다.
| 상수 | 설명 |
|---|---|
RectangleShape.Inside | 테두리는 항목의 안쪽 가장자리를 따라 그려지며, 항목의 너비에는 영향을 미치지 않습니다. |
이것이 기본값입니다.
| 상수 | 설명 |
|---|---|
RectangleShape.Middle | 테두리는 항목의 가장자리를 따라 그려지며 항목의 너비에는 영향을 미치지 않습니다. |
RectangleShape.Outside | 테두리는 항목의 바깥쪽 가장자리를 따라 그려지며, 항목의 너비는 strokeWidth 값만큼 증가합니다. |
strokeWidth도 참조하십시오 .
이 속성이 설정된 경우, 각 모서리의 베벨을 개별적으로 정의합니다. 이 속성을 ‘ false ’로 설정하면 개별 ‘ radius ’ 속성의 값에 따라 모서리가 날카롭게 처리되거나 둥글게 처리됩니다. 이 속성을 ‘ true ’로 설정하면 모서리가 베벨 처리됩니다. 이 속성이 설정되지 않은 경우, 대신 ‘ bevel ’의 값이 사용됩니다.
이 속성들은 기본적으로 설정되어 있지 않습니다. 이 속성들을 ' undefined '로 설정하면 설정되지 않은 상태로 되돌릴 수 있습니다.
다음 예제에서는 bottomRightBevel 가 true로 설정되어 있습니다:
RectangleShape {
id: rectangleShape
anchors.centerIn: parent
topLeftRadius: 0
bottomRightBevel: true
joinStyle: ShapePath.MiterJoin
}
bevel도 참조하십시오 .
이 속성을 설정하면 각 모서리의 반경을 개별적으로 정의할 수 있습니다. 값을 0으로 설정하면 해당 모서리가 날카로운 모서리가 되고, 양수 값을 설정하면 둥근 모서리가 됩니다. 이 속성을 설정하지 않으면 대신 ` radius `의 값이 사용됩니다.
이 속성들은 기본적으로 설정되어 있지 않습니다. 이 속성들을 ` undefined `로 지정하면 설정되지 않은 상태로 되돌릴 수 있습니다.
다음 예제에서는 ` radius `을 ` 10`으로, ` topLeftRadius `을 ` 0`으로 설정했습니다:
RectangleShape {
id: rectangleShape
anchors.centerIn: parent
topLeftRadius: 0
bottomRightBevel: true
joinStyle: ShapePath.MiterJoin
}
radius도 참조하십시오 .
capStyle : enumeration
이 속성은 선의 끝점이 어떻게 그려지는지를 정의합니다. 기본값은 ‘ ShapePath.SquareCap ’입니다.
| 상수 | 설명 |
|---|---|
ShapePath.FlatCap | 선의 끝점을 가리지 않는 사각형 선 끝. |
ShapePath.SquareCap | 선 끝점을 덮고 선 너비의 절반만큼 그 너머로 확장되는 사각형 선 끝. |
ShapePath.RoundCap | 둥근 선 끝. |
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()도 참조하십시오 .
drawBottom : bool [since 6.11]
이 속성은 하단 테두리가 그려지는지 여부를 결정합니다.
기본값은 ` true`입니다.
이 속성은 Qt 6.11에서 도입되었습니다.
drawLeft : bool [since 6.11]
이 속성은 왼쪽 테두리가 그려지는지 여부를 결정합니다.
기본값은 ` true`입니다.
이 속성은 Qt 6.11에서 도입되었습니다.
drawRight : bool [since 6.11]
이 속성은 오른쪽 테두리가 그려지는지 여부를 결정합니다.
기본값은 true 입니다.
이 속성은 Qt 6.11에서 도입되었습니다.
drawTop : bool [since 6.11]
이 속성은 상단 테두리가 그려지는지 여부를 결정합니다.
기본값은 ` true`입니다.
이 속성은 Qt 6.11에서 도입되었습니다.
fillColor : color
이 속성은 채우기 색상을 지정합니다.
transparent 로 설정하면 채우기가 적용되지 않습니다.
기본값은 "white" 입니다.
참고: fillGradient 중 하나가 null 이외의 값으로 설정된경우 , fillColor 대신 해당 값이 사용됩니다.
fillGradient : ShapeGradient
사각형 채우기 색상의 fillGradient입니다.
기본적으로 fillGradient는 활성화되지 않으며 값은 null입니다. 이 경우 채우기는 fillColor 의 값을 기반으로 단색을 사용합니다.
이 속성이 설정되면 ` fillColor `는 무시되며, ` ShapeGradient ` 하위 유형 중 하나를 사용하여 채우기가 수행됩니다.
참고: 여기에서는` Gradient `유형을 사용할 수 없습니다. 대신 ` LinearGradient`과 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.
fillRule : enumeration
이 속성은 채우기 규칙을 지정합니다. 기본값은 ShapePath.OddEvenFill 입니다. 채우기 규칙에 대한 설명은 QPainterPath::setFillRule()을 참조하십시오.
| 상수 | 설명 |
|---|---|
ShapePath.OddEvenFill | 홀수-짝수 채우기 규칙. |
ShapePath.WindingFill | 0이 아닌 와인딩 채우기 규칙. |
joinStyle : enumeration
이 속성은 두 개의 연결된 선 사이의 접합부가 어떻게 그려지는지를 정의합니다. 기본값은 ‘ ShapePath.BevelJoin ’입니다.
| 상수 | 설명 |
|---|---|
ShapePath.MiterJoin | 선의 바깥쪽 가장자리가 각도를 이루며 만나도록 연장되고, 이 영역이 채워집니다. |
ShapePath.BevelJoin | 두 선 사이의 삼각형 모양의 홈이 채워집니다. |
ShapePath.RoundJoin | 두 선 사이의 원호 부분이 채워집니다. |
radius : real
이 속성은 둥근 사각형을 정의하는 데 사용되는 모서리 반경을 지정합니다.
반지름이 양수인 경우 사각형 경로는 둥근 사각형으로 정의되며, 그렇지 않은 경우 일반 사각형으로 정의됩니다.
이 속성은 개별 모서리 반경 속성에 의해 재정의될 수 있습니다.
기본값은 10 입니다.
topLeftRadius, topRightRadius, bottomLeftRadius 및 bottomRightRadius도 참조하십시오 .
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.