MapQuickItem QML Type

MapQuickItem タイプは、任意の Qt Quick オブジェクトを Map 上に表示します。詳細...

• 継承されたメンバを含むすべてのメンバの一覧
• MapQuickItem はQML Maps Plugin に含まれています。

プロパティ

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

詳細な説明

MapQuickItem 型は、任意の Qt Quick オブジェクトを指定された位置とサイズで Map 上に配置するために使われます。MapQuickItem は、Map の上にアイテムを配置する場合と比較して、あたかも Map の表面上にあるかのように、Map のパン（およびオプションでズーム）に追従します。

sourceItem プロパティには描画される Qt Quick アイテムが含まれます。

位置とサイズ

マップ上の MapQuickItem の位置は、coordinate とanchorPoint の 2 つのプロパティで制御されます。coordinate だけが設定されている場合、アイテムが配置される経度／緯度座標が指定されます。設定された座標は、画面上に表示されたときに、含まれるアイテムの左上隅に並ぶ。

anchorPoint プロパティは、アイテムがオフセットされるピクセル数を設定することで、左上隅だけでなく、アイテムの他の部分に座標を合わせる方法を提供します。これを簡単に考えるには、アイテム自体のanchorPoint で指定された点が、表示されたときに指定されたcoordinate に並ぶ点であることに注意することです。

マップに固定されることに加えて、MapQuickItemはオプションでマップの縮尺に従うことができ、マップがズームインまたはズームアウトされたときにサイズを変えることができます。この動作はzoomLevel プロパティによって制御されます。zoomLevel が設定されていない場合のデフォルトの動作は、"マップ上 "ではなく、"スクリーン上 "に描画されるため、マップのズームレベルに関係なく、アイテムのサイズは変わりません。

パフォーマンス

MapQuickItem のパフォーマンスは通常、含まれている Qt Quick アイテムと同じ程度です。追加されるオーバーヘッドは元のアイテムの移動と（おそらく）拡大縮小、そして緯度経度からスクリーン位置への変換です。

制限事項

使用例

次のスニペットは、地図上にマーカーを表示するための Image オブジェクトを含む 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
    }
}

プロパティ ドキュメント