QPlaceReply Class
QPlaceReply 클래스는 QPlaceManager 인스턴스에 의해 시작된 작업을 관리하며, 보다 특화된 응답 클래스의 기본 클래스 역할을 합니다. 더 보기...
| Header: | #include <QPlaceReply> |
| qmake: | QT += location |
| Inherits: | QObject |
| Inherited By: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply, and QPlaceSearchSuggestionReply |
공개 유형
| enum | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| enum | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
공개 함수
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
공개 슬롯
| virtual void | abort() |
신호
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
보호된 함수
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
상세 설명
QPlaceReply와 그 각 특수화된 하위 클래스는 해당 작업의 상태와 결과를 관리합니다. QPlaceReply 자체는 결과가 없는 작업, 즉 작업이 성공했는지 실패했는지만 알면 되는 작업에 사용됩니다.
finished() 신호를 사용하여 작업의 진행 상황을 모니터링할 수 있습니다. 작업이 완료되면, error() 및 errorString() 메서드를 통해 작업이 성공적으로 완료되었는지 여부에 대한 정보를 확인할 수 있습니다. 성공한 경우, 응답에는 해당 작업의 결과가 포함되며, 즉 각 하위 클래스에는 작업 결과를 가져오는 데 필요한 적절한 함수가 제공됩니다.
QPlaceManager도 참조하십시오 .
멤버 유형 설명서
enum QPlaceReply::Error
작업 중에 발생한 오류를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPlaceReply::NoError | 0 | 오류가 발생하지 않았습니다 |
QPlaceReply::PlaceDoesNotExistError | 1 | 지정된 위치를 찾을 수 없음 |
QPlaceReply::CategoryDoesNotExistError | 2 | 지정된 카테고리를 찾을 수 없습니다 |
QPlaceReply::CommunicationError | 3 | 서비스 제공자와의 통신 중 오류가 발생했습니다. |
QPlaceReply::ParseError | 4 | 서비스 제공자 또는 가져오기 파일의 응답 형식이 인식되지 않았습니다. |
QPlaceReply::PermissionsError | 5 | 권한이 부족하여 작업이 실패했습니다. |
QPlaceReply::UnsupportedError | 6 | 서비스 제공자가 해당 작업을 지원하지 않습니다. |
QPlaceReply::BadArgumentError | 7 | . 제공된 매개변수가 유효하지 않습니다. |
QPlaceReply::CancelError | 8 | 작업이 취소되었습니다. |
QPlaceReply::UnknownError | 9 | 다른 범주에 해당하지 않는 오류가 발생했습니다. |
enum QPlaceReply::Type
답변의 유형을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPlaceReply::Reply | 0 | 이것은 일반적인 응답입니다. |
QPlaceReply::DetailsReply | 1 | 이것은 장소 세부 정보 검색에 대한 응답입니다. |
QPlaceReply::SearchReply | 2 | 이것은 장소 검색 작업에 대한 응답입니다. |
QPlaceReply::SearchSuggestionReply | 3 | 이것은 검색 제안 작업에 대한 응답입니다. |
QPlaceReply::ContentReply | 4 | 이 응답은 장소와 관련된 콘텐츠에 대한 것입니다. |
QPlaceReply::IdReply | 5 | 이 응답은 장소 또는 카테고리의 식별자를 반환합니다. 일반적으로 장소 또는 카테고리 저장 및 삭제 작업에 사용됩니다. |
QPlaceReply::MatchReply | 6 | 다른 제공자의 장소와 일치하는 장소를 반환하는 응답입니다. |
멤버 함수 문서
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
지정된 parent 를 사용하여 응답 객체를 생성합니다.
[virtual noexcept] QPlaceReply::~QPlaceReply()
답변 객체를 삭제합니다.
[virtual slot] void QPlaceReply::abort()
작업을 즉시 취소합니다.
aborted()도 참조하십시오 .
[signal] void QPlaceReply::aborted()
이 신호는 작업이 취소되었을 때 발생합니다.
abort()도 참조하십시오 .
[signal] void QPlaceReply::contentUpdated()
이 신호는 해당 응답에 업데이트된 콘텐츠가 있을 때 발생합니다. 플러그인에 따라 이 신호는 전혀 발생하지 않거나, ` QPlaceReply::finished()` 신호가 발생하기 전에 여러 번 발생할 수 있습니다. 일부 백엔드는 요청된 콘텐츠를 비동기적이고 점진적으로 반환할 수 있기 때문입니다.
참고: 이 신호에 연결된 슬롯 내에서 이 응답 객체를 delete 또는 deleteLater로 삭제하지마십시오 . QPlaceReply::finished 가 발생했을 때만 삭제하십시오.
QPlaceReply::Error QPlaceReply::error() const
오류 코드를 반환합니다.
setError()도 참조하십시오 .
[signal] void QPlaceReply::errorOccurred(QPlaceReply::Error error, const QString &errorString = QString())
이 신호는 해당 응답을 처리하는 과정에서 오류가 감지되었을 때 발생합니다. 이후 finished() 신호가 발생할 가능성이 높습니다.
오류는 오류 코드 ` error`로 설명됩니다. ` errorString `가 비어 있지 않은 경우, 여기에는 최종 사용자가 아닌 개발자를 위한 오류에 대한 텍스트 설명이 포함됩니다.
이 신호와 QPlaceManager::errorOccurred()은 동시에 발생합니다.
참고: 이 신호에 연결된 슬롯에서 이 reply 객체를 삭제하지마십시오 . 대신 deleteLater()을 사용하십시오.
QString QPlaceReply::errorString() const
응답의 오류 문자열을 반환합니다. 이 오류 문자열은 개발자 전용으로 사용되도록 의도된 것이며, 최종 사용자에게 표시하기에는 적합하지 않습니다.
오류가 발생하지 않은 경우, 이 문자열은 비어 있습니다.
[signal] void QPlaceReply::finished()
이 신호는 해당 응답의 처리가 완료되었을 때 발생합니다.
error()의 결과가 QPlaceReply::NoError 와 같을 경우, 처리가 성공적으로 완료된 것입니다.
이 신호와 QPlaceManager::finished()는 동시에 발송됩니다.
참고: 이 신호에 연결된 슬롯에서 이 응답 객체를 삭제하지마십시오 . 대신 deleteLater()를 사용하십시오.
setFinished()도 참조하십시오 .
bool QPlaceReply::isFinished() const
응답이 완료된 경우 true를 반환합니다.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
응답의 error 와 errorString 을 설정합니다. 이 함수는 QPlaceReply::errorOccurred(QPlaceReply::Error, const QString 및errorString) 시그널이 발생하지 않도록 합니다.
error()도 참조하십시오 .
[protected] void QPlaceReply::setFinished(bool finished)
응답이 ‘ finished ’인지 여부를 설정합니다. 이 함수는 finished() 신호를 발생시키지 않습니다.
finished()도 참조하십시오 .
[virtual] QPlaceReply::Type QPlaceReply::type() const
응답의 유형을 반환합니다.
© 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.