geoRectangle QML Value Type
geoRectangle 유형은 직사각형 모양의 지리적 영역을 나타냅니다. 더 보기...
| Import Statement: | import QtPositioning |
속성
- bottomLeft : geoCoordinate
- bottomRight : geoCoordinate
- center : geoCoordinate
- height : double
- topLeft : geoCoordinate
- topRight : geoCoordinate
- width : double
상세 설명
geoRectangle 유형은 직사각형 지리적 영역을 나타내는 지리적 사각형( geoShape )입니다. 이 유형은 지리적 사각형( QGeoRectangle)을 직접적으로 나타냅니다. 이 유형은 직사각형의 왼쪽 상단 모서리와 오른쪽 하단 모서리를 나타내는 좌표 쌍( coordinates )으로 정의됩니다. 좌표는 topLeft 및 bottomRight 속성을 통해 확인할 수 있습니다.
왼쪽 상단 또는 오른쪽 하단 좌표가 유효하지 않거나, 왼쪽 상단 좌표가 오른쪽 하단 좌표보다 남쪽에 위치한 경우, 해당 사각형은 유효하지 않은 것으로 간주됩니다.
사각형의 네 모서리 좌표는 topLeft, topRight, bottomLeft 및 bottomRight 속성을 통해 확인할 수 있습니다. center 속성을 사용하면 사각형의 중심 좌표를 얻을 수 있습니다. width 및 height 속성을 사용하면 사각형의 너비와 높이를 도(degree) 단위로 얻을 수 있습니다. 이 속성 중 하나를 설정하면 다른 속성도 그에 따라 조정됩니다.
제한 사항
geoRectangle은 절대를 지날 수 없습니다.
geoRectangle의 높이 또는 중심이 조정되어 극점 중 하나를 가로지르게 될 경우, 높이가 수정되어 사각형이 극점에 닿기는 하지만 넘지 않도록 하고, 중심 좌표가 여전히 사각형의 중심에 위치하도록 합니다.
사용 예
geoRectangle 값을 생성하려면 QtPositioning.rectangle() 함수를 사용합니다:
import QtPositioning
Item {
property geoRectangle region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1),
QtPositioning.coordinate(-27.6, 153.2))
}C++과 통합할 때, C++에서 QML로 전달되는 모든 QGeoRectangle 값은 자동으로 geoRectangle 값으로 변환되며, 그 반대의 경우도 마찬가지라는 점에 유의하십시오.
속성 문서
bottomLeft : geoCoordinate
이 속성은 이 geoRectangle 의 왼쪽 하단 좌표를 나타냅니다.
bottomRight : geoCoordinate
이 속성은 이 geoRectangle 의 오른쪽 아래 좌표를 나타냅니다.
center : geoCoordinate
이 속성은 이 geoRectangle 의 중심 좌표를 저장합니다. 자세한 내용은 QGeoRectangle::setCenter()을 참조하십시오.
height : double
이 속성은 이 geoRectangle 의 높이(도 단위)를 저장합니다. 자세한 내용은 QGeoRectangle::setHeight()을 참조하십시오.
참고: geoRectangle 이 유효하지 않은경우 높이를 설정할 수 없습니다. Qt 5.5 이전 버전의 QtPositioning 에서는 유효하지 않은 geoRectangle에 대해서도 높이 설정이 허용되었습니다.
topLeft : geoCoordinate
이 속성은 이 ` geoRectangle`의 왼쪽 상단 좌표를 나타냅니다.
topRight : geoCoordinate
이 속성은 이 geoRectangle 의 오른쪽 상단 좌표를 나타냅니다.
width : double
이 속성은 이 geoRectangle 의 너비(도 단위)를 저장합니다. 자세한 내용은 QGeoRectangle::setWidth()를 참조하십시오.
참고: geoRectangle 이 유효하지 않은경우 너비를 설정할 수 없습니다. Qt 5.5 이전 버전의 QtPositioning 에서는 유효하지 않은 geoRectangle에 대해서도 너비 설정이 허용되었습니다.
© 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.