QPlaceManagerEngine Class

QPlaceManagerEngine 클래스는 장소 기능에 대한 액세스를 제공하려는 QGeoServiceProvider 플러그인 구현자를 위한 인터페이스를 제공합니다. 더 보기...

Header: #include <QPlaceManagerEngine>
qmake: QT += location
Inherits: QObject

공용 함수

QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)
virtual ~QPlaceManagerEngine()
virtual QPlaceCategory category(const QString &categoryId) const
virtual QList<QPlaceCategory> childCategories(const QString &parentId) const
virtual QStringList childCategoryIds(const QString &categoryId) const
virtual QPlace compatiblePlace(const QPlace &original) const
virtual QUrl constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
virtual QPlaceContentReply *getPlaceContent(const QPlaceContentRequest &request)
virtual QPlaceDetailsReply *getPlaceDetails(const QString &placeId)
virtual QPlaceReply *initializeCategories()
virtual QList<QLocale> locales() const
QString managerName() const
int managerVersion() const
virtual QPlaceMatchReply *matchingPlaces(const QPlaceMatchRequest &request)
virtual QString parentCategoryId(const QString &categoryId) const
virtual QPlaceIdReply *removeCategory(const QString &categoryId)
virtual QPlaceIdReply *removePlace(const QString &placeId)
virtual QPlaceIdReply *saveCategory(const QPlaceCategory &category, const QString &parentId)
virtual QPlaceIdReply *savePlace(const QPlace &place)
virtual QPlaceSearchReply *search(const QPlaceSearchRequest &request)
virtual QPlaceSearchSuggestionReply *searchSuggestions(const QPlaceSearchRequest &request)
virtual void setLocales(const QList<QLocale> &locales)

Signals

void categoryAdded(const QPlaceCategory &category, const QString &parentId)
void categoryRemoved(const QString &categoryId, const QString &parentId)
void categoryUpdated(const QPlaceCategory &category, const QString &parentId)
void dataChanged()
void errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
void finished(QPlaceReply *reply)
void placeAdded(const QString &placeId)
void placeRemoved(const QString &placeId)
void placeUpdated(const QString &placeId)

보호된 함수

QPlaceManager *manager() const

상세 설명

참고: 백엔드 클래스에 대한 소스 또는 바이너리 호환성은 보장되지 않습니다. API는 해당 API가 개발된 Qt 버전에서만 작동하도록 보장됩니다. 그러나 API 변경은 마이너 릴리스에서만 이루어집니다. (6.6, 6.7 등).

애플리케이션 개발자는 QPlaceManagerEngine에 대해 신경 쓸 필요가 없습니다. 그러나 백엔드 구현자는 QPlaceManagerEngine에서 파생하여 추상 가상 함수에 대한 구현을 제공해야 합니다.

백엔드 작성에 대한 자세한 내용은 장소 백엔드 문서를 참조하세요.

QPlaceManager참조하세요 .

멤버 함수 문서

[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

지정된 parent, parameters 을 사용하여 구현 관련 데이터를 엔진에 전달하여 새 엔진을 구축합니다.

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

이 엔진을 파괴합니다.

[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const

주어진 categoryId 에 해당하는 카테고리를 반환합니다.

[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)

이 신호는 매니저 엔진의 데이터스토어에 category 가 추가된 경우에 발생합니다. category 의 부모는 parentId 으로 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)

이 신호는 categoryId 에 해당하는 카테고리가 매니저 엔진의 데이터스토어에서 제거되었을 때 발생합니다. 제거된 카테고리의 부모는 parentId 에 의해 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)

이 신호는 매니저 엔진의 데이터스토어에서 category 가 수정된 경우에 발생합니다. 수정된 카테고리의 부모는 parentId 로 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

parentId 에 해당하는 카테고리의 하위 카테고리 목록을 반환합니다. parentId 이 비어 있으면 최상위 카테고리가 모두 반환됩니다.

[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

categoryId 에 해당하는 카테고리의 하위 카테고리 식별자를 반환합니다. categoryId 이 비어 있으면 모든 최상위 카테고리 식별자가 반환됩니다.

[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

관리자 엔진에서 저장하기에 적합한 original 장소의 잘린 버전 또는 수정된 버전을 반환합니다.

이 매니저가 지원하는 장소 세부 정보만 수정된 버전에 존재합니다. 장소 ID와 같은 관리자 특정 데이터는 original 에서 복사되지 않습니다.

[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

주어진 icon, size 에서 아이콘 URL을 구축합니다. 주어진 파라미터와 가장 일치하는 아이콘 이미지의 URL이 반환됩니다.

[signal] void QPlaceManagerEngine::dataChanged()

*

이 신호는 기본 데이터스토어에 대규모 변경이 있고 엔진이 클라이언트가 모든 데이터를 다시 로드해야 할 만큼 급진적인 변경이라고 판단하는 경우 엔진에서 발산합니다.

이 신호가 발생하면 관련 변경 사항에 대해 다른 신호는 발생하지 않습니다.

[signal] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())

이 신호는 reply 처리 중 오류가 감지되었을 때 발생합니다. QPlaceManager::finished() 신호가 뒤따를 수 있습니다.

오류는 오류 코드 error 로 설명됩니다. errorString 이 비어 있지 않으면 최종 사용자가 아닌 개발자를 위한 오류에 대한 텍스트 설명이 포함됩니다.

이 신호와 QPlaceReply::errorOccurred() 신호가 동시에 전송됩니다.

참고: 이 신호에 연결된 슬롯의 reply 객체를 삭제하지 마세요. 대신 deleteLater()를 사용하세요.

[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)

이 신호는 reply 처리가 완료되면 전송됩니다.

reply->error()가 QPlaceReply::NoError 와 같으면 처리가 성공적으로 완료된 것입니다.

이 신호와 QPlaceReply::finished()가 동시에 전송됩니다.

참고: 이 신호에 연결된 슬롯의 reply 객체를 삭제하지 마세요. 대신 deleteLater()를 사용하세요.

[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)

request 에 지정된 매개변수에 따라 장소의 콘텐츠를 검색합니다.

[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)

주어진 placeId 에 해당하는 장소의 세부 정보를 검색합니다.

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

관리자 엔진의 카테고리를 초기화합니다.

[virtual] QList<QLocale> QPlaceManagerEngine::locales() const

기본 설정 로캘 목록을 반환합니다. 로캘은 관리자 엔진에 어떤 언어 위치와 카테고리 세부 정보를 반환해야 하는지에 대한 힌트로 사용됩니다.

처음 지정된 로캘을 수용할 수 없는 경우 관리자 엔진은 다음 로캘로 넘어가는 식으로 돌아가게 됩니다.

로캘 지원 여부는 제공업체마다 다를 수 있습니다. 로캘을 지원하는 공급업체의 경우 기본적으로 global default locale 로캘이 사용됩니다. 매니저 엔진에 로캘이 할당되지 않은 경우에는 암시적으로 글로벌 기본 로캘을 사용합니다. 로캘을 지원하지 않는 엔진의 경우 로캘 목록은 항상 비어 있습니다.

setLocales()도 참조하세요 .

[protected] QPlaceManager *QPlaceManagerEngine::manager() const

이 엔진을 생성하는 데 사용된 매니저 인스턴스를 반환합니다.

QString QPlaceManagerEngine::managerName() const

이 엔진 구현이 다른 플러그인에서 제공하는 구현과 구별하기 위해 사용하는 이름을 반환합니다.

관리자 이름은 자동으로 QGeoServiceProviderFactory::providerName()과 동일하게 설정됩니다.

int QPlaceManagerEngine::managerVersion() const

이 엔진 구현의 버전을 반환합니다.

관리자 버전은 자동으로 QGeoServiceProviderFactory::providerVersion()과 동일하게 설정됩니다.

[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)

request 에 지정된 장소와 일치하는/상응하는 장소 목록이 포함된 응답을 반환합니다.

[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

categoryId 에 해당하는 카테고리의 상위 카테고리 식별자를 반환합니다.

[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)

이 신호는 매니저 엔진의 데이터스토어에 장소가 추가된 경우 발생합니다. 추가된 특정 장소는 placeId 에 의해 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)

이 신호는 매니저 엔진의 데이터스토어에서 장소가 제거된 경우 발생합니다. 제거된 특정 장소는 placeId 에 의해 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)

이 신호는 매니저 엔진의 데이터스토어에서 장소가 수정된 경우 발생합니다. 수정된 특정 장소는 placeId 에 의해 지정됩니다.

이 신호는 QPlaceManager::NotificationsFeature를 지원하는 관리자 엔진에서만 발생합니다.

dataChanged()도 참조하세요 .

[virtual] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)

매니저 엔진의 데이터스토어에서 categoryId 에 해당하는 카테고리를 제거합니다.

[virtual] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)

매니저 엔진의 데이터스토어에서 placeId 에 해당하는 위치를 제거합니다.

[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)

parentId 으로 지정된 카테고리의 하위 카테고리인 category 을 저장합니다. 비어 있는 parentIdcategory 이 최상위 카테고리로 저장됨을 의미합니다.

[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)

지정된 place 을 매니저 엔진의 데이터스토어에 저장합니다.

request 에 지정된 매개 변수에 따라 장소를 검색합니다.

[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)

에 지정된 매개변수에 따라 검색어 제안 세트를 요청합니다 request.

[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)

기본 설정 목록 설정 locales.

locales()도 참조하세요 .

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