MapQuickItem QML Type

Der Typ MapQuickItem zeigt ein beliebiges Qt Quick Objekt auf einer Karte an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• MapQuickItem ist Teil des QML Maps Plugin.

Eigenschaften

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

Detaillierte Beschreibung

Der Typ MapQuickItem wird verwendet, um ein beliebiges Qt Quick Objekt an einer bestimmten Stelle und in einer bestimmten Größe auf einer Karte zu platzieren. Im Vergleich zu einem über der Karte schwebenden Element folgt ein MapQuickItem dem Schwenken (und optional dem Zoomen) der Karte, als ob es sich auf der Kartenoberfläche befände.

Die Eigenschaft sourceItem enthält das zu zeichnende Element Qt Quick, das von jeder Art von sichtbarem Typ sein kann.

Positionierung und Größenbestimmung

Die Positionierung des MapQuickItems auf der Karte wird durch zwei Eigenschaften gesteuert: coordinate und anchorPoint. Wenn nur coordinate gesetzt ist, wird eine Längen-/Breitengrad-Koordinate angegeben, an der das Element platziert werden soll. Die eingestellte Koordinate stimmt mit der oberen linken Ecke des enthaltenen Elements überein, wenn es auf dem Bildschirm angezeigt wird.

Die Eigenschaft anchorPoint bietet eine Möglichkeit, die Koordinate mit anderen Teilen des Elements als nur der linken oberen Ecke auszurichten, indem eine Anzahl von Pixeln festgelegt wird, um die das Element versetzt wird. Eine einfache Möglichkeit, darüber nachzudenken, besteht darin, dass der durch anchorPoint angegebene Punkt auf dem Element selbst der Punkt ist, der bei der Anzeige mit dem angegebenen coordinate übereinstimmt.

Zusätzlich zur Verankerung auf der Karte kann das MapQuickItem optional dem Maßstab der Karte folgen und seine Größe ändern, wenn die Karte vergrößert oder verkleinert wird. Dieses Verhalten wird durch die Eigenschaft zoomLevel gesteuert. Wenn zoomLevel nicht gesetzt ist, wird das Element standardmäßig "auf dem Bildschirm" und nicht "auf der Karte" gezeichnet, so dass seine Größe unabhängig von der Zoomstufe der Karte gleich bleibt.

Leistung

Die Leistung eines MapQuickItems liegt normalerweise in der gleichen Größenordnung wie die des enthaltenen Qt Quick Elements allein. Die hinzugefügten Kosten belaufen sich auf eine Übersetzung und (möglicherweise) Skalierung des ursprünglichen Elements sowie auf eine Umwandlung von Längen- und Breitengraden in die Bildschirmposition.

Beschränkungen

Beispielverwendung

Das folgende Snippet zeigt ein MapQuickItem, das ein Image-Objekt enthält, um einen Marker auf der Karte anzuzeigen. Diese Strategie wird verwendet, um die Kartenmarkierungen im MapViewer-Beispiel anzuzeigen.

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

Eigenschaft Dokumentation