Rectangle QML Type

선택적 테두리가 있는 채워진 직사각형을 그립니다. 더 보기...

Import Statement: import QtQuick
Inherits:

Item

속성

상세 설명

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

모양

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

border.colorborder.width 속성을 설정하여 사각형에 고유한 색상과 두께를 가진 선택적 테두리를 추가할 수 있습니다. 채우기 색상 없이 테두리를 칠하려면 색상을 '투명'으로 설정합니다.

radius 속성을 사용하여 둥근 사각형을 만들 수도 있습니다. 이렇게 하면 직사각형의 모서리에 곡선 모서리가 생기므로 Item::antialiasing 속성을 설정하여 모양을 개선하는 것이 적절할 수 있습니다. 다른 모서리에 대해 반경을 개별적으로 설정하려면 topLeftRadius, topRightRadius, bottomLeftRadiusbottomRightRadius 속성을 사용할 수 있습니다.

사용 예

다음 예는 직사각형 항목에 대한 몇 가지 공통 속성의 효과를 보여 주며, 이 예에서는 정사각형을 만드는 데 사용됩니다:

import QtQuick

Rectangle {
    width: 100
    height: 100
    color: "red"
    border.color: "black"
    border.width: 5
    radius: 10
}

성능

Item::antialiasing 속성을 사용하면 렌더링 성능이 저하되는 대신 둥근 직사각형의 모양이 향상됩니다. 움직이는 직사각형의 경우 이 속성을 설정 해제하고 정지된 경우에만 설정하는 것이 좋습니다.

Image참조하세요 .

속성 문서

antialiasing : bool

사각형에 앤티앨리어싱을 사용할지 여부를 결정하는 데 사용됩니다. 앤티앨리어싱은 이 프로퍼티의 성능에 미치는 영향에 대한 정보를 제공합니다.

기본값은 반경이 있는 직사각형의 경우 참이고, 그렇지 않으면 거짓입니다.


border group

border.color : color

border.pixelAligned : bool

border.width : int

직사각형의 테두리를 그리는 데 사용되는 너비와 색상입니다.

너비가 1이면 가는 선이 생성됩니다. 선이 없는 경우 너비 0 또는 투명한 색상을 사용합니다.

참고: 직사각형 테두리의 너비는 앵커를 사용하는 경우 직사각형 자체의 지오메트리나 다른 항목에 대한 직사각형의 위치에 영향을 주지 않습니다.

테두리는 직사각형의 경계 내에 렌더링됩니다.

pixelAlignedtrue (기본값)인 경우 렌더링된 테두리 너비는 디바이스 픽셀 비율 배율을 적용한 후 정수 픽셀로 반올림됩니다. pixelAlignedfalse 으로 설정하면 분수 테두리 너비가 허용되며, 이는 antialiasing 이 활성화된 경우에 바람직할 수 있습니다.


bottomLeftRadius : real [since 6.7]

이 속성은 왼쪽 하단 모서리를 그리는 데 사용되는 반경을 보유합니다.

bottomLeftRadius를 설정하지 않으면 radius 가 대신 사용됩니다. bottomLeftRadius가 0이면 모서리가 날카롭게 그려집니다.

참고: 이 API는 기술 미리보기로 간주되며 향후 Qt 버전에서 변경되거나 제거될 수 있습니다.

이 프로퍼티는 Qt 6.7에 도입되었습니다.

radius, topLeftRadius, topRightRadius, bottomRightRadius참조하십시오 .


bottomRightRadius : real [since 6.7]

이 프로퍼티는 오른쪽 하단 모서리를 그리는 데 사용되는 반지름을 보유합니다.

bottomRightRadius가 설정되어 있지 않으면 radius 이 대신 사용됩니다. bottomRightRadius가 0이면 모서리가 날카롭게 그려집니다.

참고: 이 API는 기술 미리보기로 간주되며 향후 Qt 버전에서 변경되거나 제거될 수 있습니다.

이 속성은 Qt 6.7에 도입되었습니다.

radius, topLeftRadius, topRightRadius, bottomLeftRadius참조하십시오 .


color : color

이 속성은 직사각형을 채우는 데 사용되는 색을 보유합니다.

기본 색은 흰색입니다.

다음 예는 16진수 및 명명된 색상 표기법을 사용하여 지정된 색상이 있는 직사각형을 보여줍니다:

Rectangle {
    color: "#00B000"
    width: 80; height: 80
}

Rectangle {
    color: "steelblue"
    y: 100; width: 80; height: 80
}

그라데이션과 색상이 모두 지정된 경우 그라데이션이 사용됩니다.

gradient참조하세요 .


gradient : var

직사각형을 채우는 데 사용할 그라데이션입니다.

이 속성을 사용하면 간단한 수직 또는 수평 그라데이션을 만들 수 있습니다. 직사각형에 회전을 추가하여 다른 그라데이션을 만들 수도 있습니다.

Rectangle {
    width: 80; height: 80
    color: "lightsteelblue"
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        orientation: Gradient.Horizontal
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    rotation: 90
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

이 속성은 QGradient::Preset 의 그라데이션 사전 설정도 사용할 수 있습니다. 그러나 직사각형은 단순한 수직 또는 수평 그라데이션만 지원하므로 지원되지 않는 각도가 있는 사전 설정은 가장 가까운 표현으로 되돌아갑니다.

Rectangle {
    width: 80; height: 80
    gradient: Gradient.NightFade
}

Rectangle {
    width: 80; height: 80
    gradient: "SunnyMorning"
}

그라데이션과 색상을 모두 지정한 경우 그라데이션이 사용됩니다.

Gradientcolor참조하세요 .


radius : real

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

반경이 0이 아닌 경우 직사각형이 둥근 직사각형으로 그려지고, 그렇지 않으면 일반 직사각형으로 그려집니다. 개별 모서리 반경도 설정할 수 있습니다(아래 참조). 이 값은 반경을 재정의합니다. 설정하지 않은 경우( undefined)로 설정하면 반경이 대신 사용됩니다.

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


topLeftRadius : real [since 6.7]

이 속성은 왼쪽 상단 모서리를 그리는 데 사용되는 반경을 보유합니다.

topLeftRadius가 설정되지 않은 경우 radius 가 대신 사용됩니다. topLeftRadius가 0이면 모서리가 날카롭게 그려집니다.

참고: 이 API는 기술 미리보기로 간주되며 향후 Qt 버전에서 변경되거나 제거될 수 있습니다.

이 프로퍼티는 Qt 6.7에 도입되었습니다.

radius, topRightRadius, bottomLeftRadius, bottomRightRadius참조하십시오 .


topRightRadius : real [since 6.7]

이 프로퍼티는 오른쪽 상단 모서리를 그리는 데 사용되는 반지름을 보유합니다.

topRightRadius가 설정되어 있지 않으면 radius 이 대신 사용됩니다. topRightRadius가 0이면 모서리가 날카롭게 그려집니다.

참고: 이 API는 기술 미리보기로 간주되며 향후 Qt 버전에서 변경되거나 제거될 수 있습니다.

이 속성은 Qt 6.7에 도입되었습니다.

radius, topLeftRadius, bottomLeftRadius, bottomRightRadius참조하십시오 .


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