MapQuickItem QML Type

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

• 継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

• anchorPoint : point
• coordinate : geoCoordinate
• sourceItem : Item

詳細な説明

MapQuickItem 型は、任意のQt Quick オブジェクトを、指定された位置とサイズでマップ上に配置するために使用されます。マップの上にアイテムを浮かせた場合と比較して、MapQuickItem は、あたかもマップの表面にあるかのように、マップのパン操作に追従します。

sourceItem プロパティには、描画対象となるQt Quick アイテムが格納されており、これは任意の可視タイプにすることができます。

配置とサイズ設定

MapQuickItemのマップ上での位置決めは、coordinate とanchorPoint の2つのプロパティによって制御されます。coordinate のみが設定されている場合、それはアイテムを配置する経度・緯度の座標を指定します。設定された座標は、画面上に表示された際に、含まれるアイテムの左上隅と一致します。

anchorPoint プロパティを使用すると、アイテムの左上隅以外の位置に座標を合わせるために、アイテムをオフセットするピクセル数を設定できます。簡単に言えば、anchorPoint で指定されたアイテム上の点は、表示時に指定されたcoordinate と一致する点であると考えてください。

使用例

以下のスニペットは、マップ上にマーカーを表示するために Image オブジェクトを含む MapQuickItem を示しています。この手法は、マップの例でマップマーカーを表示するために使用されています。

import QtQuick
import QtPositioning
import QtLocation

MapQuickItem {
    id: poiQt

    sourceItem: Image {
        id: markerImage
        source: "location-marker.png"

        Text {
            id: markerText
            text: "The Qt Company"
            font.pointSize: 7
            font.bold: true
            anchors.bottom: parent.top
            anchors.horizontalCenter: parent.horizontalCenter
        }
    }
    center {
        latitude: 65.05877
        longitude: 25.45545
    }

    anchorPoint: Qt.point(sourceItem.width / 2, sourceItem.height / 2)
}

プロパティのドキュメント

anchorPoint : point

このプロパティは、sourceItem 上のどの点が、地図上の座標と一致するかを決定します。

coordinate : geoCoordinate

このプロパティには、MapQuickItem のアンカー座標が格納されます。anchorPoint で指定されたsourceItem 上の点は、マップ上に描画される際、この座標と位置合わせされます。

下の画像には、anchorPoint プロパティの値以外はすべて同一の MapQuickItems が 3 つあります。各アイテムのanchorPoint の値は、アイテムの上に表示されています。

sourceItem : Item

このプロパティには、マップ上に描画されるソースアイテムが格納されます。

特定のQtライセンスの下で利用可能です。
詳細はこちらをご覧ください。