QGeoRectangle Class
QGeoRectangle 클래스는 직사각형 모양의 지리적 영역을 정의합니다. 더 보기...
| 헤더: | #include <QGeoRectangle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| 상속: | QGeoShape |
속성
|
공개 함수
| QGeoRectangle() | |
| QGeoRectangle(const QGeoShape &other) | |
| QGeoRectangle(const QList<QGeoCoordinate> &coordinates) | |
| QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight) | |
| QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight) | |
| QGeoRectangle(const QGeoRectangle &other) | |
| ~QGeoRectangle() | |
| QGeoCoordinate | bottomLeft() const |
| QGeoCoordinate | bottomRight() const |
| QGeoCoordinate | center() const |
| bool | contains(const QGeoRectangle &rectangle) const |
| void | extendRectangle(const QGeoCoordinate &coordinate) |
| double | height() const |
| bool | intersects(const QGeoRectangle &rectangle) const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setHeight(double degreesHeight) |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
| void | setTopRight(const QGeoCoordinate &topRight) |
| void | setWidth(double degreesWidth) |
| QString | toString() const |
| QGeoCoordinate | topLeft() const |
| QGeoCoordinate | topRight() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoRectangle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoRectangle | united(const QGeoRectangle &rectangle) const |
| double | width() const |
| QGeoRectangle & | operator=(const QGeoRectangle &other) |
| QGeoRectangle | operator|(const QGeoRectangle &rectangle) const |
| QGeoRectangle & | operator|=(const QGeoRectangle &rectangle) |
상세 설명
사각형은 사각형의 왼쪽 상단 좌표를 지정하는 ` QGeoCoordinate `와 사각형의 오른쪽 하단 좌표를 지정하는 ` QGeoCoordinate `를 통해 정의됩니다.
왼쪽 상단 또는 오른쪽 하단 좌표가 유효하지 않거나, 왼쪽 상단 좌표가 오른쪽 하단 좌표보다 남쪽에 있는 경우 지리적 사각형은 유효하지 않은 것으로 간주됩니다.
지오 직사각형은 극점을 절대 통과할 수 없습니다.
몇 가지 메서드는 지오 사각형이 중심 좌표, 지오 사각형의 너비(도 단위) 및 지오 사각형의 높이(도 단위)로 정의된 것처럼 동작합니다.
지오 사각형의 높이 또는 중심이 극 중 하나를 가로지르게 조정된 경우, 지오 사각형이 극에 닿기는 하지만 가로지르지 않도록 높이가 수정되며, 중심 좌표는 여전히 지오 사각형의 중심에 위치하게 됩니다.
이 클래스는 QML에서 geoRectangle 로도 접근할 수 있습니다.
속성 문서
bottomLeft : QGeoCoordinate
이 속성은 이 지오 사각형의 왼쪽 하단 좌표를 저장합니다.
이 속성은 Qt 5.5에서 도입되었지만, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
| QGeoCoordinate | bottomLeft() const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
이 속성은 이 지오 사각형의 오른쪽 아래 모서리 좌표를 저장합니다.
이 속성은 Qt 5.5에서 도입되었으나, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
| QGeoCoordinate | bottomRight() const |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
이 속성은 이 지리적 직사각형의 중심을 저장합니다.
이 속성은 Qt 5.5에서 도입되었으나, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
QGeoShape::center도 참조하십시오 .
height : double
이 속성은 이 지리적 직사각형의 높이를 도(°) 단위로 저장합니다.
이 지오 사각형이 유효하지 않은 경우, 이 속성의 값은 정의되지 않습니다.
새로운 높이가 0.0보다 작거나 이 지오 사각형이 유효하지 않은 경우, 이 속성은 변경되지 않습니다. 중심, 너비 및 높이를 기준으로 유효하지 않은 지오 사각형의 값을 설정하려면, 먼저 setCenter()를 사용하여 지오 사각형을 유효하게 만들어야 합니다.
높이 변경으로 인해 지오 사각형이 극점을 가로지르게 되는 경우, 지오 사각형이 극점에 닿기만 하도록 높이가 조정됩니다.
이 변경은 중심 좌표가 여전히 지오 사각형의 중심에 위치하도록 이루어지므로, 결과적으로 지오 사각형의 높이가 예상보다 작아질 수 있습니다.
180.0은 새로운 높이가 180 이상일 때만 사용되는 높이입니다.
이 속성은 Qt 5.5에서 도입되었지만, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재했습니다.
액세스 함수:
topLeft : QGeoCoordinate
이 속성은 이 지오 사각형의 왼쪽 상단 좌표를 저장합니다.
이 속성은 Qt 5.5에서 도입되었으나, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
| QGeoCoordinate | topLeft() const |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
이 속성은 이 지오 사각형의 오른쪽 상단 좌표를 저장합니다.
이 속성은 Qt 5.5에서 도입되었으나, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
| QGeoCoordinate | topRight() const |
| void | setTopRight(const QGeoCoordinate &topRight) |
width : double
이 속성은 이 지리적 직사각형의 너비를 도(°) 단위로 저장합니다.
이 지오 사각형이 유효하지 않은 경우, 이 속성의 값은 정의되지 않습니다.
새로운 너비가 0.0보다 작거나 이 지리적 사각형이 유효하지 않은 경우, 이 함수는 아무 작업도 수행하지 않습니다. 중심, 너비 및 높이를 기준으로 유효하지 않은 지리적 사각형의 값을 설정하려면, 먼저 setCenter()을 사용하여 지리적 사각형을 유효하게 만들어야 합니다.
360.0은 새로운 너비가 360 이상인 경우에만 사용되는 너비입니다. 이러한 경우, 지오 사각형의 가장 왼쪽 경도는 -180.0도로, 가장 오른쪽 경도는 180.0도로 설정됩니다.
이 속성은 Qt 5.5에서 도입되었지만, 관련 액세서 함수는 이 클래스의 첫 번째 버전부터 존재해 왔습니다.
액세스 함수:
멤버 함수 문서
QGeoRectangle::QGeoRectangle()
유효하지 않은 새로운 지리적 직사각형을 생성합니다.
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
other 의 내용을 바탕으로 지리적 직사각형을 생성합니다.
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
coordinates 의 모든 요소를 포함하는, 최소 크기의 새로운 지오 레크탱글을 생성합니다.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
왼쪽 상단 좌표 topLeft 와 오른쪽 하단 좌표 bottomRight 를 갖는 새로운 지리적 직사각형을 생성합니다.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
center 를 중심으로, 너비는 degreesWidth (도 단위), 높이는 degreesHeight(도 단위)인 새로운 지리적 사각형을 생성합니다.
degreesHeight 로 인해 지오 사각형이 극점 중 하나를 넘어가는 경우, 지오 사각형의 높이는 극점까지만 확장되도록 잘립니다. 지오 사각형의 중심은 변경되지 않으며, 중심점이 잘린 지오 사각형의 중심에 오도록 높이가 조정됩니다.
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
other 의 내용을 바탕으로 지리적 직사각형을 생성합니다.
[noexcept] QGeoRectangle::~QGeoRectangle()
이 지오 레티클을 삭제합니다.
QGeoCoordinate QGeoRectangle::bottomLeft() const
이 지오 사각형의 왼쪽 하단 좌표를 반환합니다.
참고: bottomLeft 속성의게터 함수입니다.
setBottomLeft()도 참조하십시오 .
QGeoCoordinate QGeoRectangle::bottomRight() const
이 지오 사각형의 오른쪽 하단 좌표를 반환합니다.
참고: bottomRight 속성에 대한게터 함수입니다.
setBottomRight()도 참조하십시오 .
QGeoCoordinate QGeoRectangle::center() const
이 지오 사각형의 중심을 반환합니다. QGeoShape::center()와 동일합니다.
참고: center 속성에 대한게터 함수입니다.
참조: setCenter().
bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const
지리적 사각형 rectangle 이 이 지리적 사각형 내에 포함되는지 여부를 반환합니다.
[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
지오 사각형을 확장하여 해당 좌표도 포함하도록 합니다 coordinate
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
double QGeoRectangle::height() const
이 지리적 사각형의 높이를 도(°) 단위로 반환합니다.
이 지오 직사각형이 유효하지 않은 경우 반환 값은 정의되지 않습니다.
참고: height 속성에 대한게터 함수입니다.
setHeight()도 참조하십시오 .
[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const
지리적 직사각형 rectangle 이 이 지리적 직사각형과 교차하는지 여부를 반환합니다.
두 지오 사각형의 상단 또는 하단 변이 극점 중 하나에 위치하는 경우, 변이 극점에 있을 때는 경도가 관련이 없으므로 지오 사각형들이 교차하는 것으로 간주됩니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
이 지오 사각형의 왼쪽 아래 좌표를 bottomLeft 로 설정합니다.
참고: bottomLeft 속성에 대한세터 함수입니다.
bottomLeft()도 참조하십시오 .
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
이 지오 사각형의 오른쪽 아래 좌표를 bottomRight 로 설정합니다.
참고: bottomRight 속성에 대한세터 함수입니다.
bottomRight()도 참조하십시오 .
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
이 지오 사각형의 중심을 center 로 설정합니다.
이로 인해 지오 사각형이 극점 중 하나를 가로지르게 되는 경우, 지오 사각형의 높이는 지오 사각형이 극점까지만 뻗어나가도록 잘립니다. 지오 사각형의 중심은 변경되지 않으며, 중심점이 잘린 지오 사각형의 중심에 오도록 높이가 조정됩니다.
참고: center 속성에 대한설정 함수입니다.
center()도 참조하십시오 .
void QGeoRectangle::setHeight(double degreesHeight)
이 지오 사각형의 높이를 도(degree) 단위로 ‘ degreesHeight ’로 설정합니다.
참고: height 속성에 대한세터 함수입니다.
height()도 참조하십시오 .
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
이 지오 사각형의 왼쪽 상단 좌표를 topLeft 로 설정합니다.
참고: topLeft 속성에 대한세터 함수입니다.
topLeft()도 참조하십시오 .
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
이 지오 사각형의 오른쪽 상단 좌표를 topRight 로 설정합니다.
참고: topRight 속성에 대한세터 함수입니다.
topRight()도 참조하십시오 .
void QGeoRectangle::setWidth(double degreesWidth)
이 지오 사각형의 너비를 도(degree) 단위로 degreesWidth 로 설정합니다.
참고: width 속성의세터 함수입니다.
width()도 참조하십시오 .
[invokable] QString QGeoRectangle::toString() const
지오 사각형의 속성을 문자열로 반환합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
QGeoCoordinate QGeoRectangle::topLeft() const
이 지오 사각형의 왼쪽 상단 좌표를 반환합니다.
참고: topLeft 속성의게터 함수입니다.
setTopLeft()도 참조하십시오 .
QGeoCoordinate QGeoRectangle::topRight() const
이 지오 사각형의 오른쪽 상단 좌표를 반환합니다.
참고: topRight 속성에 대한게터 함수입니다.
setTopRight()도 참조하십시오 .
[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
이 지리적 사각형을 degreesLatitude 만큼 북쪽으로, degreesLongitude 만큼 동쪽으로 이동시킵니다.
degreesLatitude 와 degreesLongitude 의 음수 값은 각각 남쪽 및 서쪽 방향으로의 변환을 의미합니다.
이동으로 인해 지오 사각형이 극점을 가로지르게 될 경우, 지오 사각형의 상단 또는 하단 가장자리가 극점에 닿을 때까지 이동되지만, 그 이상은 이동되지 않습니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
degreesLatitude 만큼 북쪽으로, degreesLongitude 만큼 동쪽으로 변환된 이 지리적 사각형의 복사본을 반환합니다.
degreesLatitude 와 degreesLongitude 의 음수 값은 각각 남쪽 방향 및 서쪽 방향으로의 변환을 나타냅니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
translate()도 참조하십시오 .
[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
이 지오 사각형과 rectangle 를 모두 포함하는 가장 작은 지오 사각형을 반환합니다.
두 지리적 직사각형의 중심이 정확히 180.0도 떨어져 있는 경우, 너비는 360.0도로 설정되며, 가장 왼쪽 경도는 -180.0도로, 가장 오른쪽 경도는 180.0도로 설정됩니다. 이는 결과가 피연산자의 순서에 영향을 받지 않도록 하기 위함입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
double QGeoRectangle::width() const
이 지리적 사각형의 너비를 도(°) 단위로 반환합니다.
이 지오 사각형이 유효하지 않은 경우 반환 값은 정의되지 않습니다.
참고: width 속성에 대한게터 함수입니다.
setWidth()도 참조하십시오 .
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
other 를 이 지리적 사각형에 할당하고, 이 지리적 사각형에 대한 참조를 반환합니다.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
이 지오 사각형과 rectangle 를 모두 포함하는 가장 작은 지오 사각형을 반환합니다.
두 지리적 직사각형의 중심이 정확히 180.0도 떨어져 있는 경우, 너비는 360.0도로 설정되며, 가장 왼쪽 경도는 -180.0도, 가장 오른쪽 경도는 180.0도로 설정됩니다. 이는 결과가 피연산자의 순서에 영향을 받지 않도록 하기 위함입니다.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
이 지오 사각형과 rectangle 을 모두 포함하는 가장 작은 지오 사각형을 반환합니다.
두 지리적 직사각형의 중심이 정확히 180.0도 떨어져 있는 경우, 너비는 360.0도로 설정되며, 가장 왼쪽 경도는 -180.0도, 가장 오른쪽 경도는 180.0도로 설정됩니다. 이는 결과가 피연산자의 순서에 영향을 받지 않도록 하기 위함입니다.
© 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.