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::NoError0오류가 발생하지 않았습니다.
QPlaceReply::PlaceDoesNotExistError1지정한 장소를 찾을 수 없습니다.
QPlaceReply::CategoryDoesNotExistError2지정한 카테고리를 찾을 수 없습니다.
QPlaceReply::CommunicationError3서비스 제공업체와 통신하는 동안 오류가 발생했습니다.
QPlaceReply::ParseError4서비스 제공업체의 응답 또는 가져오기 파일의 형식이 인식할 수 없는 형식입니다.
QPlaceReply::PermissionsError5권한이 부족하여 작업이 실패했습니다.
QPlaceReply::UnsupportedError6서비스 제공업체에서 작업을 지원하지 않습니다.
QPlaceReply::BadArgumentError7. 제공된 매개 변수가 유효하지 않습니다.
QPlaceReply::CancelError8작업이 취소되었습니다.
QPlaceReply::UnknownError9다른 범주에 속하지 않는 오류가 발생했습니다.

enum QPlaceReply::Type

답글의 유형을 설명합니다.

Constant설명
QPlaceReply::Reply0일반적인 답글입니다.
QPlaceReply::DetailsReply1장소 세부 정보 검색에 대한 응답입니다.
QPlaceReply::SearchReply2장소 검색 작업에 대한 응답입니다.
QPlaceReply::SearchSuggestionReply3검색 추천 작업에 대한 응답입니다.
QPlaceReply::ContentReply4장소와 관련된 콘텐츠에 대한 응답입니다.
QPlaceReply::IdReply5장소 또는 카테고리의 식별자를 반환하는 응답입니다. 일반적으로 장소 또는 카테고리 저장 및 제거 작업에 사용됩니다.
QPlaceReply::MatchReply6다른 제공업체의 장소와 일치하는 장소를 반환하는 응답입니다.

멤버 함수 문서

[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()가 전송되기 전에 이 신호가 전송되지 않거나 여러 번 전송될 수 있습니다.

참고: 이 신호에 연결된 슬롯에서 나중에 이 응답 개체를 삭제하거나 삭제하지 마세요. QPlaceReply::finished 에서만 수행하세요.

QPlaceReply::Error QPlaceReply::error() const

오류 코드를 반환합니다.

setError()도 참조하세요 .

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

이 신호는 이 회신 처리 과정에서 오류가 감지되었을 때 전송됩니다. finished () 신호가 뒤따를 수 있습니다.

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

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

참고: 이 신호에 연결된 슬롯에서 이 회신 개체를 삭제하지 마세요. 대신 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)

응답의 errorerrorString 을 설정합니다. 이 함수를 사용하면 QPlaceReply::errorOccurred(QPlaceReply::Error, const QString &errorString) 신호가 전송되지 않습니다.

error()도 참조하세요 .

[protected] void QPlaceReply::setFinished(bool finished)

응답이 finished 인지 여부의 상태를 설정합니다. 이 함수를 사용하면 finished() 신호가 전송되지 않습니다.

finished()도 참조하세요 .

[virtual] QPlaceReply::Type QPlaceReply::type() const

답장의 유형을 반환합니다.

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