QGeoRectangle Class
QGeoRectangle 클래스는 직사각형 지리적 영역을 정의합니다. 더 보기...
Header: | #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 으로 정의됩니다.
왼쪽 위 또는 오른쪽 아래 좌표가 유효하지 않거나 왼쪽 위 좌표가 오른쪽 아래 좌표의 남쪽인 경우 지리적 직사각형은 유효하지 않은 것으로 간주됩니다.
지리적 직사각형은 절대 극을 교차할 수 없습니다.
몇몇 메서드는 지리적 사각형이 중심 좌표, 지리적 사각형의 너비(도) 및 높이(도)로 정의된 것처럼 동작합니다.
지오 사각형의 높이 또는 중심이 극 중 하나를 교차하도록 조정되면 지오 사각형이 극에 닿지만 교차하지 않도록 높이가 수정되고 중심 좌표는 여전히 지오 사각형의 중앙에 있습니다.
이 클래스는 Qt 5.5부터 Q_GADGET. C++ 및 QML에서 직접 사용할 수 있습니다.
프로퍼티 문서
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 속성에 대한 Getter 함수입니다.
setBottomRight()도 참조하세요 .
QGeoCoordinate QGeoRectangle::center() const
이 지리적 사각형의 중심을 반환합니다. QGeoShape::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
이 지리적 사각형의 높이를 도 단위로 반환합니다.
이 지리적 사각형이 유효하지 않은 경우 반환 값은 정의되지 않습니다.
참고: 속성 높이에 대한 게터 함수입니다.
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)
이 지오 사각형의 높이를 도 단위로 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)
이 지리적 사각형의 너비를 도 단위로 degreesWidth 로 설정합니다.
참고: 속성의 세터 함수 width.
width()도 참조하세요 .
[invokable]
QString QGeoRectangle::toString() const
지리적 사각형 속성을 문자열로 반환합니다.
참고: 이 함수는 메타객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
QGeoCoordinate QGeoRectangle::topLeft() const
이 지오 사각형의 왼쪽 상단 좌표를 반환합니다.
참고: topLeft 속성에 대한 Getter 함수입니다.
setTopLeft()도 참조하세요 .
QGeoCoordinate QGeoRectangle::topRight() const
이 지오 사각형의 오른쪽 상단 좌표를 반환합니다.
참고: topRight 속성에 대한 Getter 함수입니다.
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도 떨어져 있으면 가장 왼쪽 경도는 -180.0도로 설정하고 가장 오른쪽 경도는 180.0도로 설정하여 너비를 360.0도로 설정합니다. 이는 피연산자의 순서에 관계없이 결과가 나오도록 하기 위한 것입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
double QGeoRectangle::width() const
이 지리적 사각형의 너비를 도 단위로 반환합니다.
이 지리적 사각형이 유효하지 않은 경우 반환 값은 정의되지 않습니다.
참고: 속성 너비에 대한 게터 함수입니다.
setWidth()도 참조하세요 .
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
이 지리적 사각형에 other 을 할당하고 이 지리적 사각형에 대한 참조를 반환합니다.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
이 지오 사각형과 rectangle 를 모두 포함하는 가장 작은 지오 사각형을 반환합니다.
두 지오 사각형의 중심이 정확히 180.0도 떨어져 있으면 가장 왼쪽 경도는 -180.0도로 설정하고 가장 오른쪽 경도는 180.0도로 설정하여 너비를 360.0도로 설정합니다. 이는 피연산자의 순서에 관계없이 결과가 나오도록 하기 위한 것입니다.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
이 지오 사각형과 rectangle 를 모두 포함하는 가장 작은 지오 사각형을 반환합니다.
두 지오 사각형의 중심이 정확히 180.0도 떨어져 있으면 가장 왼쪽 경도는 -180.0도로 설정되고 가장 오른쪽 경도는 180.0도로 설정되어 너비가 360.0도로 설정됩니다. 이는 피연산자의 순서에 관계없이 결과가 나오도록 하기 위한 것입니다.
© 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.