MapPolyline QML Type

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

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

속성

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

방법

• void addCoordinate(coordinate)
• coordinate containsCoordinate(coordinate) (since QtLocation 5.6)
• coordinate coordinateAt(index) (since QtLocation 5.6)
• void insertCoordinate(index, coordinate) (since QtLocation 5.6)
• int pathLength() (since QtLocation 5.6)
• void removeCoordinate(coordinate)
• void removeCoordinate(index) (since QtLocation 5.6)
• void replaceCoordinate(index, coordinate) (since QtLocation 5.6)
• void setPath(geoPath path)

상세 설명

MapPolyline 유형은 coordinates 의 순서 지정된 목록으로 지정된 폴리라인을 지도에 표시합니다.

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

mapPolyline.path[0].latitude = 5;

기본적으로 폴리라인은 두께 1픽셀의 검은색 선으로 표시됩니다. 이는 ` line.width ` 및 ` line.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

이 속성은 선 속성 그룹에 속합니다. 선 속성 그룹에는 선을 그릴 때 사용되는 너비와 색상이 포함됩니다.

너비는 픽셀 단위로 표시되며 지도의 확대/축소 수준과 무관합니다. 기본값은 너비 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 가 경로의 일부인 경우 true를 반환합니다.

이 메서드는 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)

geoPath 유형을 사용하여 path 을 설정합니다.

path도 참조하십시오 .