MapPolygon QML Type

MapPolygon 유형은 지도에 다각형을 표시합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록
• MapPolygon은 QML Maps 플러그인의 일부입니다.

속성

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• color : color
• path : list<coordinate>
• referenceSurface : enum (since 6.5)

방법

• void addCoordinate(coordinate)
• void removeCoordinate(coordinate)

상세 설명

MapPolygon 유형은 coordinates 의 정렬된 목록으로 지정된 다각형을 지도에 표시합니다. 최상의 표시 효과와 결과를 얻으려면 다각형은 단순해야 합니다(자신과 교차하지 않아야 함).

addCoordinate 및 removeCoordinate 메서드를 사용하여 언제든지 좌표를 추가하거나 제거할 수 있습니다. 또한 QML의 다른 목록 요소와 마찬가지로 좌표를 수정할 수도 있습니다:

mapPolygon.path[0].latitude = 5;

"직선" 모서리(한쪽 모서리의 위도가 모두 같고, 다른 쪽 모서리의 위도도 모두 같은)를 가진 사각형을 그릴 때는 MapRectangle 유형이 더 간단한 2점 API를 제공합니다.

기본적으로 다각형은 채우기 없이 1픽셀 두께의 검은색 테두리로 표시됩니다. 모양을 변경하려면 color, border.color 및 border.width 속성을 사용하십시오.

사용 예

다음 코드 조각은 호주 브리즈번 근처에 세 개의 꼭짓점을 가진 삼각형을 표시하기 위해 MapPolygon을 사용하는 예시입니다. 삼각형은 녹색으로 채워져 있으며, 1픽셀 두께의 검은색 테두리가 있습니다.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

속성 설명서

autoFadeIn : bool

이 속성은 매우 낮은 확대/축소 수준에서 지도를 확대할 때 항목이 자동으로 페이드 인되는지 여부를 결정합니다. 기본적으로 이 속성의 값은 ‘ true ’입니다. 이 속성을 ‘ false ’로 설정하면 지도 항목의 불투명도가 항상 ‘ QtQuick::Item::opacity ’ 속성에 지정된 값(기본값은 1.0)을 따르게 됩니다.

border group

이 속성은 테두리 속성 그룹에 속합니다. 테두리 속성 그룹에는 다각형의 테두리를 그리는 데 사용되는 너비와 색상이 포함됩니다.

너비는 픽셀 단위로 표시되며 지도의 확대/축소 수준과 무관합니다.

기본값은 너비 1 픽셀의 검은색 테두리에 해당합니다. 선을 표시하지 않으려면 너비를 0으로 설정하거나 투명 색상을 사용하십시오.

color : color

이 속성은 다각형을 채우는 데 사용되는 색상을 지정합니다.

기본값은 투명입니다.

path : list<coordinate>

이 속성은 다각형을 정의하는 좌표의 정렬된 목록을 포함합니다. 경로에 서로 다른 좌표가 3개 미만이면 정의되지 않은 동작이 발생합니다.

addCoordinate 및 removeCoordinate도 참조하십시오 .

referenceSurface : enum [since 6.5]

이 속성은 다각형의 기준 표면을 결정합니다. ‘ QLocation::ReferenceSurface::Map ’로 설정하면 지도상에서 다각형의 꼭짓점들이 직선으로 연결됩니다. ‘ QLocation::ReferenceSurface::Globe ’로 설정하면, 구면 위의 두 점을 연결하는 최단 경로인 대원 경로를 따라 꼭짓점들이 연결됩니다. 기본값은 ‘ QLocation::ReferenceSurface::Map ’입니다.

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

메서드 문서

void addCoordinate(coordinate)

지정된 coordinate 을 경로에 추가합니다.

removeCoordinate 및 path도 참조하십시오 .

void removeCoordinate(coordinate)

경로에서 ` coordinate `을 제거합니다. 동일한 좌표가 여러 개 있는 경우, 가장 마지막에 추가된 항목이 제거됩니다.

coordinate 가 경로에 없는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.

addCoordinate 및 path도 참조하십시오 .