MapQuickItem QML Type

MapQuickItem 유형은 맵에 임의의 Qt Quick 개체를 표시합니다. 더 보기...

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

속성

• anchorPoint : QPointF
• autoFadeIn : bool
• coordinate : coordinate
• sourceItem : object
• zoomLevel : real

상세 설명

MapQuickItem 유형은 임의의 Qt Quick 객체를 지정된 위치와 크기로 맵에 배치하는 데 사용됩니다. 맵 위에 항목을 플로팅하는 것과 비교하여 MapQuickItem은 마치 맵 표면에 있는 것처럼 맵의 패닝(및 선택 사항으로 확대/축소)을 따릅니다.

sourceItem 속성에는 그려질 Qt Quick 항목이 포함되며, 이는 모든 종류의 표시 유형이 될 수 있습니다.

위치 및 크기 조정

맵에서 MapQuickItem의 위치는 coordinate 및 anchorPoint 속성으로 제어됩니다. coordinate 만 설정된 경우 항목이 배치될 경도/위도 좌표가 지정됩니다. 설정된 좌표는 화면에 표시될 때 포함된 항목의 왼쪽 상단 모서리와 정렬됩니다.

anchorPoint 속성은 항목이 오프셋될 픽셀 수를 설정하여 좌표를 왼쪽 상단 모서리뿐만 아니라 항목의 다른 부분과 정렬하는 방법을 제공합니다. 간단히 생각하면 아이템 자체에서 anchorPoint 에 지정된 지점이 표시될 때 지정된 coordinate 과 일직선이 되는 지점이라고 생각하면 됩니다.

맵에 고정되는 것 외에도 MapQuickItem은 선택적으로 맵의 배율을 따르고 맵을 확대하거나 축소할 때 크기를 변경할 수 있습니다. 이 동작은 zoomLevel 속성에 의해 제어됩니다. zoomLevel 을 설정하지 않은 경우 기본 동작은 항목이 '지도'가 아닌 '화면'에 그려지도록 하여 지도의 확대/축소 수준에 관계없이 크기가 동일하게 유지되도록 하는 것입니다.

성능

MapQuickItem의 성능은 일반적으로 포함된 Qt Quick 항목 자체의 성능과 비슷합니다. 오버헤드는 원본 항목의 번역 및 (아마도) 크기 조정과 경도 및 위도에서 화면 위치로의 변환에 따라 추가됩니다.

제한 사항

사용 예

다음 코드 조각은 이미지 객체를 포함하는 MapQuickItem을 사용하여 지도에 마커를 표시하는 방법을 보여줍니다. 이 전략은 MapViewer 예제에서 지도 마커를 표시하는 데 사용됩니다.

MapQuickItem {
    id: marker
    anchorPoint.x: image.width/4
    anchorPoint.y: image.height

    HoverHandler {
        id: hoverHandler
    }
    TapHandler {
        id: tapHandler
        acceptedButtons: Qt.RightButton
        gesturePolicy: TapHandler.WithinBounds
        onTapped: {
            mapview.currentMarker = -1
            for (var i = 0; i< mapview.markers.length; i++){
                if (marker == mapview.markers[i]){
                    mapview.currentMarker = i
                    break
                }
            }
            mapview.showMarkerMenu(marker.coordinate)
        }
    }
    DragHandler {
        id: dragHandler
        grabPermissions: PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType
    }

    sourceItem: Image {
        id: image
    }
}

속성 문서