QGeoAreaMonitorInfo Class
QGeoAreaMonitorInfo 클래스는 근접 여부를 모니터링할 영역 또는 지역의 매개변수를 정의합니다. 더 보기...
| 헤더: | #include <QGeoAreaMonitorInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- 상속된 멤버를 포함한 모든 멤버 목록
- QGeoAreaMonitorInfo는 ‘암시적 공유 클래스’에 속합니다.
공개 함수
| QGeoAreaMonitorInfo(const QString &name = QString()) | |
| QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other) | |
(since 6.2) | QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other) |
| ~QGeoAreaMonitorInfo() | |
| QGeoShape | area() const |
| QDateTime | expiration() const |
| QString | identifier() const |
| bool | isPersistent() const |
| bool | isValid() const |
| QString | name() const |
| QVariantMap | notificationParameters() const |
| void | setArea(const QGeoShape &newShape) |
| void | setExpiration(const QDateTime &expiry) |
| void | setName(const QString &name) |
| void | setNotificationParameters(const QVariantMap ¶meters) |
| void | setPersistent(bool isPersistent) |
(since 6.2) void | swap(QGeoAreaMonitorInfo &other) |
(since 6.2) QGeoAreaMonitorInfo & | operator=(QGeoAreaMonitorInfo &&other) |
| QGeoAreaMonitorInfo & | operator=(const QGeoAreaMonitorInfo &other) |
관련 비멤버
| bool | operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor) |
| bool | operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor) |
상세 설명
영역 모니터링의 목적은 사용자가 관심 영역에 접근했을 때 이를 알리는 것입니다. 일반적으로 이러한 영역은 원형 영역( QGeoCircle)으로 표현됩니다. 원의 중심은 관심 지점을 나타내며, 그 주변 영역은 알림이 전송되는 지리적 범위를 정의합니다.
QGeoAreaMonitorInfo 객체는 이름이 비어 있지 않고 유효한 area()를 가지고 있을 때 유효합니다. 이러한 객체는 모니터링 프로세스를 시작하고 중지하기 위해 QGeoAreaMonitorSource 에 등록되어야 합니다. 위치 파악 엔진이 활성 상태를 유지해야 하고 각 QGeoAreaMonitorInfo 인스턴스와 현재 위치를 대조해야 하므로, 광범위한 모니터링은 리소스를 많이 소모할 수 있다는 점에 유의하십시오.
시스템에 가해지는 부하를 더욱 줄이기 위해 설정할 수 있는 선택적 속성들이 있습니다. 각 모니터링 대상 영역에는 만료일이 지정될 수 있으며, 만료일이 도래하면 모니터링 대상 영역이 모니터링 소스에서 자동으로 제거됩니다. 또 다른 옵션은 모니터링 대상 영역의 지속 시간을 조정하는 것입니다. isPersistent()를 호출한 QGeoAreaMonitorInfo는 현재 애플리케이션의 수명 주기 이후에도 활성 상태를 유지합니다. 모니터링 애플리케이션이 실행 중이지 않을 때 해당 영역에 진입하면 애플리케이션이 시작됩니다. 이 기능은 모든 플랫폼에서 사용할 수 있는 것은 아닙니다. 사용 가능 여부는 QGeoAreaMonitorSource::supportedAreaMonitorFeatures()를 통해 확인할 수 있습니다.
QGeoAreaMonitorSource도 참조하십시오 .
멤버 함수 문서
[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())
지정된 ` name`을 사용하여 `QGeoAreaMonitorInfo` 객체를 생성합니다.
name()도 참조하십시오 .
QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
other 의 복사본으로 QGeoAreaMonitorInfo 객체를 생성합니다.
[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
other 에서 이동하여 QGeoAreaMonitorInfo 객체를 생성합니다.
이동된 QGeoAreaMonitorInfo는 소멸되거나 할당될 수만 있다는 점에 유의하십시오. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우의 결과는 정의되지 않습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()
소멸자
QGeoShape QGeoAreaMonitorInfo::area() const
모니터링 대상 영역의 경계를 반환합니다. 이 영역은 비어 있어서는 안 됩니다.
setArea()도 참조하십시오 .
QDateTime QGeoAreaMonitorInfo::expiration() const
만료일을 반환합니다.
활성 상태인 QGeoAreaMonitorInfo 의 유효 기간이 만료되면 해당 리전은 더 이상 모니터링되지 않으며, QGeoAreaMonitorInfo 객체는 active monitors 목록에서 제거됩니다.
만료된 QDateTime 가 유효하지 않은 경우, QGeoAreaMonitorInfo 객체는 만료일이 없는 것으로 간주됩니다. 이는 객체가 영구적인 경우 모니터링 기간이 무기한으로 지속됨을 의미하며, 객체가 비영구적인 경우 현재 애플리케이션이 종료될 때까지 모니터링이 지속됨을 의미합니다.
setExpiration() 및 QGeoAreaMonitorSource::activeMonitors()도 참조하십시오 .
QString QGeoAreaMonitorInfo::identifier() const
QGeoAreaMonitorInfo 객체의 식별자를 반환합니다. 이 식별자는 새로운 QGeoAreaMonitorInfo 객체가 생성될 때 자동으로 생성됩니다.
bool QGeoAreaMonitorInfo::isPersistent() const
QGeoAreaMonitorInfo 가 영구적인 경우 true를 반환합니다. 이 속성의 기본값은 false입니다.
비영속적인 QGeoAreaMonitorInfo 는 모니터 객체를 소유한 애플리케이션이 중지되면 시스템에 의해 제거됩니다. 영속적인 객체는 활성 상태를 유지하며, 애플리케이션이 다시 시작되면 불러올 수 있습니다.
시스템이 지속성 있는 QGeoAreaMonitorInfo 와 연관된 이벤트를 트리거하면, 관련 애플리케이션이 다시 시작되고 적절한 신호가 발송됩니다.
setPersistent()도 참조하십시오 .
bool QGeoAreaMonitorInfo::isValid() const
모니터가 유효한 경우 true를 반환합니다. 유효한 QGeoAreaMonitorInfo 는 name()의 값이 비어 있지 않고, 모니터링 대상 영역이 empty()가 아닌 경우를 말합니다. 그렇지 않은 경우 이 함수는 false를 반환합니다.
QString QGeoAreaMonitorInfo::name() const
QGeoAreaMonitorInfo 객체의 이름을 반환합니다. 이 이름은 사용자가 확인할 수 있도록 사용해야 합니다.
setName()도 참조하십시오 .
QVariantMap QGeoAreaMonitorInfo::notificationParameters() const
이 QGeoAreaMonitorInfo 에서 사용하는 플랫폼별 매개변수 집합을 반환합니다.
setNotificationParameters()도 참조하십시오 .
void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)
모니터링할 영역을 newShape 로 설정합니다.
area()도 참조하십시오 .
void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)
만료 날짜와 시간을 expiry 로 설정합니다.
expiration()도 참조하십시오 .
void QGeoAreaMonitorInfo::setName(const QString &name)
사용자에게 표시되는 name 를 설정합니다.
name()도 참조하십시오 .
void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap ¶meters)
QGeoAreaMonitorInfo 에서 사용하는 플랫폼별 parameters 집합을 설정합니다.
notificationParameters()도 참조하십시오 .
void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)
QGeoAreaMonitorInfo 객체의 지속성을 isPersistent 로 설정합니다.
이 플래그를 설정한다고 해서 QGeoAreaMonitorSource 가 지속적 모니터링을 지원한다는 것을 의미하지는 않습니다. 이 기능의 사용 가능 여부를 확인하려면 QGeoAreaMonitorSource::supportedAreaMonitorFeatures()를 사용할 수 있습니다.
isPersistent()도 참조하십시오 .
[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)
이 QGeoAreaMonitorInfo 객체를 other 로 교체합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)
other 를 이 QGeoAreaMonitorInfo 객체에 이동 할당하고, 이 QGeoAreaMonitorInfo 객체에 대한 참조를 반환합니다.
이동된 QGeoAreaMonitorInfo 는 소멸되거나 할당될 수만 있다는 점에 유의하십시오. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우의 결과는 정의되지 않습니다.
이 함수는 Qt 6.2에서 도입되었습니다.
QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)
이 QGeoAreaMonitorInfo 객체에 other 를 할당하고, 이 QGeoAreaMonitorInfo 객체에 대한 참조를 반환합니다.
관련 비회원
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
lhs 객체의 값 중 하나라도 rhs 객체의 값과 일치하지 않으면 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
지정된 ` monitor `를 지정된 ` stream`에 기록합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
lhs 객체의 모든 값이 rhs 객체의 값과 동일한 경우 true 을 반환합니다. 그렇지 않은 경우 false 을 반환합니다.
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)
지정된 ` stream `에서 영역 모니터링 데이터를 읽어와 주어진 ` monitor`에 저장합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
© 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.