geoshape QML Value Type

Ein Geoshape-Typ stellt ein abstraktes geografisches Gebiet dar. Mehr...

Import Statement: import QtPositioning

Detaillierte Beschreibung

Dieser Typ ist eine QML-Darstellung von QGeoShape, die ein abstraktes geografisches Gebiet ist. Er enthält Attribute und Methoden, die für alle geografischen Gebiete gelten. Um Objekte zu erstellen, die ein gültiges geografisches Gebiet darstellen, verwenden Sie georectangle oder geocircle.

Das Attribut isValid kann verwendet werden, um zu prüfen, ob der Geoshape ein gültiges geografisches Gebiet darstellt.

Das Attribut isEmpty kann verwendet werden, um zu prüfen, ob das geoshape eine Region mit einer geometrischen Fläche von 0 darstellt.

Die Methode contains() kann verwendet werden, um zu prüfen, ob ein coordinate innerhalb des Geoshape liegt.

Beispiel für die Verwendung

Verwenden Sie Eigenschaften des Typs var, um einen geoshape zu speichern. Um einen geoshape zu erstellen, verwenden Sie eine der unten beschriebenen Methoden.

Um einen geoshape Wert zu erstellen, geben Sie ihn als "shape()" String an:

import QtPositioning

Item {
    property var region: "shape()"
}

oder mit der Funktion QtPositioning.shape():

import QtPositioning

Item {
    property var region: QtPositioning.shape()
}

Bei der Integration mit C++ ist zu beachten, dass jeder QGeoShape Wert, der von C++ an QML übergeben wird, automatisch in einen geoshape Wert umgewandelt wird und umgekehrt.

Eigenschaften

isEmpty

bool isEmpty

Gibt zurück, ob dieses Geoshape leer ist. Ein leerer Geoshape ist eine Region, die eine geometrische Fläche von 0 hat.

isValid

bool isValid

Gibt zurück, ob diese Geoshape gültig ist.

Ein Geoshape wird als ungültig betrachtet, wenn einige der Daten, die zur eindeutigen Beschreibung des Geoshape erforderlich sind, nicht oder auf einen ungeeigneten Wert gesetzt wurden.

Typ

ShapeType type

Gibt den aktuellen Typ des Shapes zurück.

  • GeoShape.UnknownType - Der Typ des Shapes ist nicht bekannt.
  • GeoShape.RectangleType - Das Shape ist ein georectangle.
  • GeoShape.CircleType - Das Shape ist ein geocircle.
  • GeoShape.PathType - Das Shape ist ein geopath. (Seit Qt 5.9)
  • GeoShape.PolygonType - Das Shape ist ein geopolygon. (Seit Qt 5.10)

Diese QML-Eigenschaft wurde mit Qt 5.5 eingeführt.

Methoden

enthält()

bool contains(coordinate coord)

Gibt true zurück, wenn die durch coord angegebene coordinate innerhalb dieses Geoshape liegt; andernfalls wird false zurückgegeben.

© 2025 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.