Back to Qt.io
Contact Us Blog Download Qt

MapRectangle QML Type

MapRectangle 유형은 맵에 직사각형을 표시합니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

속성

상세 설명

MapRectangle 유형은 맵에 직사각형을 표시합니다. 직사각형은 정확히 4개의 꼭지점과 4개의 "직선" 가장자리를 가진 다각형의 특수한 경우입니다. 이 경우 "직선"이란 왼쪽 위쪽 점이 오른쪽 위쪽 점(위쪽 가장자리)과 위도가 같고 왼쪽 아래쪽 점이 오른쪽 아래쪽 점(아래쪽 가장자리)과 위도가 같다는 의미입니다. 마찬가지로 왼쪽의 포인트는 경도가 같고 오른쪽의 포인트는 경도가 같습니다.

직사각형을 지정하려면 topLeft 및 bottomRight 포인트가 필요하며, 둘 다 coordinate 으로 지정해야 합니다.

기본적으로 직사각형은 투명한 채우기와 1픽셀 두께의 검은색 테두리로 표시됩니다. color , border.color 및 border.width 속성을 사용하여 변경할 수 있습니다.

참고: MapPolygon 유형과 마찬가지로 맵직사각형은 지리적 항목이므로 맵직사각형을 드래그하면 지리적 좌표 공간에서 꼭지점이 다시 계산됩니다. 위도가 다른 곳으로 드래그하면 항목이 늘어나는 것처럼 보이지만 가장자리는 직선으로 유지됩니다.

사용 예

다음 코드 조각은 호주 브리즈번 근처의 (-27, 153)에서 (-28, 153.5)에 걸쳐 있는 MapRectangle이 포함된 맵을 보여줍니다. 직사각형은 녹색으로 채워져 있으며 테두리는 2픽셀 검은색입니다.

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            latitude: -28
            longitude: 153.5
        }
    }
}

속성 문서

autoFadeIn : bool

이 속성은 매우 낮은 줌 레벨부터 지도를 확대할 때 항목이 자동으로 페이드 인할지 여부를 설정합니다. 기본값은 true 입니다. 이 속성을 false 로 설정하면 맵 항목에 항상 QtQuick::Item::opacity 속성(기본값은 1.0)으로 지정된 불투명도가 적용됩니다.


border group

border.color : color

border.width : int

이 속성은 테두리 속성 그룹의 일부입니다. 테두리 속성 그룹에는 직사각형의 테두리를 그리는 데 사용되는 너비와 색상이 있습니다. 너비는 픽셀 단위이며 맵의 확대/축소 수준과 무관합니다.

기본값은 너비가 1픽셀인 검은색 테두리에 해당합니다. 선이 없는 경우 너비 0 또는 투명한 색상을 사용합니다.


bottomRight : coordinate

이 속성은 경도, 위도 및 고도를 검색하는 데 사용할 수 있는 MapRectangle 의 오른쪽 하단 좌표를 보유합니다.


color : color

이 속성은 직사각형의 채우기 색을 보유합니다. 채우기를 사용하지 않으려면 투명한 색상을 사용합니다.


opacity : real

이 속성은 항목의 불투명도를 보유합니다. 불투명도는 0(완전 투명)에서 1(완전 불투명) 사이의 숫자로 지정됩니다. 기본값은 1입니다.

불투명도가 0인 항목은 마우스 이벤트를 계속 수신합니다. 마우스 이벤트를 중지하려면 항목의 표시 속성을 false로 설정합니다.


referenceSurface : enum [since 6.5]

이 속성은 직사각형의 기준 표면을 결정합니다. QLocation::ReferenceSurface::Map 로 설정된 경우 가장자리 포인트는 맵에서 직선으로 연결됩니다. QLocation::ReferenceSurface::Globe 로 설정된 경우 가장자리 점은 구에서 두 점을 최단거리로 연결하는 큰 원 경로를 따라 연결됩니다. 기본값은 QLocation::ReferenceSurface::Map 입니다.

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


topLeft : coordinate

이 프로퍼티는 MapRectangle 의 왼쪽 상단 좌표를 보유하여 경도, 위도 및 고도를 검색하는 데 사용할 수 있습니다.


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