geoshape QML Value Type

도형 유형은 추상적인 지리적 영역을 나타냅니다. 더 보기...

Import Statement: import QtPositioning

상세 설명

이 유형은 추상적인 지리적 영역인 QGeoShape 의 QML 표현입니다. 여기에는 모든 지리적 영역에 공통적인 속성과 메서드가 포함되어 있습니다. 유효한 지리적 영역을 나타내는 개체를 만들려면 georectangle 또는 geocircle 을 사용합니다.

isValid 속성은 지오셰이프가 유효한 지리적 영역을 나타내는지 테스트하는 데 사용할 수 있습니다.

isEmpty 속성은 도형이 기하학적 영역이 0인 영역을 나타내는지 테스트하는 데 사용할 수 있습니다.

contains() 메서드는 coordinate 이 지오셰이프 내에 있는지 테스트하는 데 사용할 수 있습니다.

사용 예

var 유형의 속성을 사용하여 geoshape 을 저장합니다. geoshape 을 만들려면 아래 설명된 메서드 중 하나를 사용합니다.

geoshape 값을 만들려면 "shape()" 문자열로 지정합니다:

import QtPositioning

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

또는 QtPositioning.shape() 함수를 사용합니다:

import QtPositioning

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

C++와 통합할 때 C++에서 QML로 전달된 QGeoShape 값은 자동으로 geoshape 값으로 변환되며, 그 반대의 경우도 마찬가지입니다.

속성

isEmpty

bool isEmpty

이 도형이 비어 있는지 여부를 반환합니다. 비어 있는 도형은 기하학적 영역이 0인 영역입니다.

isValid

bool isValid

이 도형이 유효한지 여부를 반환합니다.

도형을 명확하게 설명하는 데 필요한 데이터 중 일부가 설정되지 않았거나 부적절한 값으로 설정된 경우 도형이 유효하지 않은 것으로 간주됩니다.

type

ShapeType type

도형의 현재 유형을 반환합니다.

  • GeoShape.UnknownType - 도형의 유형을 알 수 없습니다.
  • GeoShape.RectangleType - 도형이 georectangle 입니다.
  • GeoShape.CircleType - 도형은 geocircle 입니다.
  • GeoShape.PathType - 모양은 geopath 입니다 (Qt 5.9 이후).
  • GeoShape.PolygonType - 모양은 geopolygon 입니다. (Qt 5.10 이후)

이 QML 프로퍼티는 Qt 5.5에서 도입되었습니다.

메서드

contains()

bool contains(coordinate coord)

coord 에 지정된 coordinate 가 이 도형 안에 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

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