QPlaceManagerEngine Class
QPlaceManagerEngine 클래스는 장소 기능에 대한 액세스를 제공하고자 하는 ‘ QGeoServiceProvider ’ 플러그인 구현자에게 인터페이스를 제공합니다. 더 보기...
| Header: | #include <QPlaceManagerEngine> |
| qmake: | QT += location |
| Inherits: | QObject |
공개 함수
| QPlaceManagerEngine(const QVariantMap ¶meters, 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) |
신호
| 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는 개발 시 사용된 Qt 버전에서만 작동이 보장됩니다. 단, API 변경은 마이너 릴리스(6.6, 6.7 등)에서만 이루어집니다.
애플리케이션 개발자는 QPlaceManagerEngine에 대해 신경 쓸 필요가 없습니다. 그러나 백엔드 구현자는 QPlaceManagerEngine을 상속받아 추상 가상 함수에 대한 구현을 제공해야 합니다.
백엔드 작성에 대한 자세한 내용은 Places 백엔드 문서를 참조하십시오.
QPlaceManager도 참조하십시오 .
멤버 함수 문서
[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap ¶meters, 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 를 저장합니다. parentId 가 비어 있으면 category 가 최상위 카테고리로 저장됩니다.
[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)
지정된 place 를 매니저 엔진의 데이터스토어에 저장합니다.
[virtual] QPlaceSearchReply *QPlaceManagerEngine::search(const QPlaceSearchRequest &request)
request 에 지정된 매개변수에 따라 장소를 검색합니다.
[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)
request 에 지정된 매개변수에 따라 일련의 검색어 제안 목록을 요청합니다.
[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)
선호하는 locales 목록을 설정합니다.
locales()도 참조하십시오 .
© 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.