MapPolyline QML Type

맵폴리라인 유형은 맵에 폴리라인을 표시합니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.0

속성

방법

상세 설명

맵폴리라인 유형은 coordinates 의 정렬된 목록으로 지정된 폴리라인을 맵에 표시합니다. 경로의 coordinates 은 폴리라인에 추가한 후 직접 변경할 수 없습니다. 대신 path 을 var에 복사하고 복사본을 수정한 다음 복사본을 path 에 다시 할당합니다.

var path = mapPolyline.path;
path[0].latitude = 5;
mapPolyline.path = path;

addCoordinateremoveCoordinate 메서드를 사용하여 언제든지 좌표를 추가하고 제거할 수도 있습니다.

기본적으로 폴리라인은 1픽셀 두께의 검은색 선으로 표시됩니다. line.widthline.color 속성을 사용하여 변경할 수 있습니다.

사용 예

다음 코드 조각은 호주 브리즈번 근처에서 '물음표'(?)의 윗부분과 같은 모양을 만드는 4점이 있는 MapPolyline을 보여줍니다. 그려진 선의 너비는 3픽셀이고 색상은 녹색입니다.

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

속성 문서

autoFadeIn : bool

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


line group

line.color : color

line.width : int

이 속성은 선 속성 그룹의 일부입니다. 선 속성 그룹은 선을 그리는 데 사용되는 너비와 색상을 보유합니다.

너비는 픽셀 단위이며 맵의 확대/축소 수준과 무관합니다. 기본값은 너비가 1픽셀인 검은색 테두리에 해당합니다.

선이 없는 경우 너비 0 또는 투명한 색상을 사용합니다.


path : list<coordinate>

이 속성은 폴리라인을 정의하는 좌표의 정렬된 목록을 보유합니다.


referenceSurface : enum [since 6.5]

이 속성은 폴리라인의 참조 서페이스를 결정합니다. QLocation::ReferenceSurface::Map 로 설정된 경우 폴리라인 꼭지점은 맵에서 직선으로 연결됩니다. QLocation::ReferenceSurface::Globe 로 설정된 경우 정점은 구에서 두 점을 최단거리로 연결하는 큰원 경로를 따라 연결됩니다. 기본값은 QLocation::ReferenceSurface::Map 입니다.

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


메서드 문서

void addCoordinate(coordinate)

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

insertCoordinate, removeCoordinate, path참조하십시오 .


[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

주어진 coordinate 이 경로의 일부인 경우 참을 반환합니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.


[since QtLocation 5.6] coordinate coordinateAt(index)

주어진 index 에서 폴리라인의 좌표를 가져옵니다. 인덱스가 경로의 경계를 벗어나면 잘못된 좌표가 반환됩니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.


[since QtLocation 5.6] void insertCoordinate(index, coordinate)

주어진 index 경로에 coordinate 을 삽입합니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.

addCoordinate, removeCoordinate, path참조하십시오 .


[since QtLocation 5.6] int pathLength()

폴리라인의 좌표 수를 반환합니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.

path참조하십시오 .


void removeCoordinate(coordinate)

경로에서 coordinate 을 제거합니다. 동일한 좌표의 인스턴스가 여러 개 있는 경우 마지막에 추가된 인스턴스가 제거됩니다.

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

addCoordinate, insertCoordinate, path참조하세요 .


[since QtLocation 5.6] void removeCoordinate(index)

주어진 index 에서 경로의 좌표를 제거합니다.

index 가 유효하지 않으면 이 메서드는 아무 작업도 수행하지 않습니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.

addCoordinate, insertCoordinate, path참조하십시오 .


[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

주어진 index 에서 현재 경로의 좌표를 새로운 coordinate 으로 바꿉니다.

이 메서드는 QtLocation 5.6에 도입되었습니다.

addCoordinate, insertCoordinate, removeCoordinate, path도 참조하십시오 .


void setPath(geopath path)

지오패스 유형을 사용하여 path 를 설정합니다.

path도 참조하십시오 .


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