Auf dieser Seite

MapItemView QML Type

Die `MapItemView` dient dazu, die Karte anhand eines Modells zu füllen. Mehr...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5
Inherits:

QtObject

Eigenschaften

Ausführliche Beschreibung

Die MapItemView dient dazu, eine Map mit MapItems aus einem Modell zu füllen. Der Typ MapItemView ist nur dann sinnvoll, wenn er in einer Map enthalten ist, d. h., er hat keine eigenständige Darstellung.

Anwendungsbeispiel

Dieses Beispiel veranschaulicht, wie das „MapViewItem“-Objekt verwendet wird, um ein „ route “ in einer „ map “ anzuzeigen:

import QtQuick
import QtPositioning
import QtLocation

Map {
    RouteModel {
        id: routeModel
    }

    MapItemView {
        model: routeModel
        delegate: routeDelegate
    }

    Component {
        id: routeDelegate

        MapRoute {
            route: routeData
            line.color: "blue"
            line.width: 5
            smooth: true
            opacity: 0.8
        }
    }
}

Dokumentation der Eigenschaften

add : Transition [since QtLocation 5.12]

Diese Eigenschaft enthält den Übergang, der auf die von der Ansicht erstellten Kartenelemente angewendet wird, wenn diese instanziiert und der Karte hinzugefügt werden.

Diese Eigenschaft wurde in QtLocation 5.12 eingeführt.

autoFitViewport : bool

Diese Eigenschaft legt fest, ob der Ansichtsbereich automatisch verschoben und gezoomt wird, um alle Kartenelemente anzuzeigen, wenn Elemente hinzugefügt oder entfernt werden.

Der Standardwert ist „false“.

delegate : Component

Diese Eigenschaft enthält den Delegaten, der festlegt, wie jedes Element im Modell angezeigt werden soll. Die Komponente muss genau ein von `MapItem` abgeleitetes Objekt als Stammobjekt enthalten.

delegateModelAccess : enumeration [since 6.10]

Diese Eigenschaft legt fest, wie Delegaten auf das Modell zugreifen können.

KonstanteBeschreibung
DelegateModel.ReadOnlyVerhindert, dass Delegaten das Modell über Kontexteigenschaften, das Objekt „ model “ oder erforderliche Eigenschaften schreiben können.
DelegateModel.ReadWriteErlaubt Delegaten, das Modell über Kontexteigenschaften, das „ model “-Objekt oder erforderliche Eigenschaften zu ändern.
DelegateModel.Qt5ReadWriteErlaubt Delegaten, das Modell über das „ model “-Objekt und Kontexteigenschaften zu schreiben, jedoch nicht über erforderliche Eigenschaften.

Die Standardeinstellung ist „ DelegateModel.Qt5ReadWrite “.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch „Modelle und Ansichten“ unter „ Qt Quick “ #Ändern von Modelldaten.

model : model

Diese Eigenschaft enthält das Modell, das die Daten bereitstellt, die zur Erstellung der vom Delegaten definierten Kartenelemente verwendet werden. Es werden ausschließlich Modelle auf Basis von „ QAbstractItemModel “ unterstützt.

remove : Transition [since QtLocation 5.12]

Diese Eigenschaft enthält den Übergang, der auf die von der Ansicht erstellten Kartenelemente angewendet wird, wenn diese entfernt werden.

Diese Eigenschaft wurde in QtLocation 5.12 eingeführt.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.