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
    }
}

プロパティ ドキュメント