Класс QPlaceReply
Класс QPlaceReply управляет операцией, запущенной экземпляром QPlaceManager, и служит базовым классом для более специализированных ответов. Подробнее...
| Заголовок: | #include <QPlaceReply> |
| qmake: | QT += location |
| С момента: | Qt 5.6 |
| Наследуется от: | QObject |
| Наследуется: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply и QPlaceSearchSuggestionReply |
Типы
| перечисление | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ..., UnknownError } |
| перечисление | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ..., MatchReply } |
Открытые функции
| QPlaceReply(QObject *parent = nullptr) | |
| виртуальный | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| виртуальный QPlaceReply::Type | type() const |
- 34 открытых функций, унаследованных от QObject
Открытые слоты
| виртуальный void | abort() |
- 1 открытый слот, унаследованный от QObject
Сигналы
| void | aborted() |
| void | error(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
- 2 сигнала, унаследованные от QObject
Защищенные функции
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
- 9 защищенных функций, унаследованных от QObject
Дополнительные унаследованные члены
- 1 свойство, унаследованное от QObject
- 1 открытая переменная, унаследованная от QObject
- 10 статических открытых членов, унаследованных от QObject
- 2 защищенные переменные, унаследованные от QObject
Подробное описание
Класс QPlaceReply управляет операцией, запущенной экземпляром QPlaceManager, и служит базовым классом для более специализированных ответов.
Класс QPlaceReply и каждый из его специализированных подклассов управляют состоянием и результатами соответствующих операций. Сам QPlaceReply используется для операций, не имеющих результатов, то есть необходимо только знать, завершилась ли операция успешно или нет.
Сигнал finished() можно использовать для отслеживания хода операции. После завершения операции методы error() и errorString() предоставляют информацию о том, завершилась ли операция успешно. В случае успеха ответ будет содержать результаты этой операции, то есть каждый подкласс будет иметь соответствующие функции для получения результатов операции.
См. также QPlaceManager.
Документация по типам членов
перечисление 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 |
Произошла ошибка, не вписывающаяся ни в одну из других категорий. |
перечисление QPlaceReply::Type
Описывает тип ответа.
| Постоянная | Значение | Описание |
|---|---|---|
QPlaceReply::Reply |
0 |
Это общий ответ. |
QPlaceReply::DetailsReply |
1 |
Это ответ для получения деталей места |
QPlaceReply::SearchReply |
2 |
Это ответ для поиска места. |
QPlaceReply::SearchSuggestionReply |
3 |
Это ответ для поиска предложения. |
QPlaceReply::ContentReply |
4 |
Это ответ для содержимого, связанного с местом. |
QPlaceReply::IdReply |
5 |
Это ответ, возвращающий идентификатор места или категории. Обычно используется для операций сохранения и удаления мест или категорий. |
QPlaceReply::MatchReply |
6 |
Это ответ, возвращающий места, соответствующие местам от другого поставщика. |
Документация по функциям членов
QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Конструирует объект ответа с заданным parent.
[virtual] QPlaceReply::~QPlaceReply()
Уничтожает объект ответа.
[virtual slot] void QPlaceReply::abort()
Немедленно отменяет операцию.
См. также aborted().
[signal] void QPlaceReply::aborted()
Этот сигнал излучается, когда операция была отменена.
Эта функция была добавлена в Qt 5.9.
См. также abort().
QPlaceReply::Error QPlaceReply::error() const
Возвращает код ошибки.
См. также setError().
[signal] void QPlaceReply::error(QPlaceReply::Error error, const QString &errorString = QString())
Этот сигнал испускается, когда в обработке данного ответа обнаружена ошибка. За ним, вероятно, последует сигнал finished().
Ошибка будет описана кодом ошибки error. Если errorString не пустая, она будет содержать текстовое описание ошибки, предназначенное для разработчиков, а не конечных пользователей.
Этот сигнал и QPlaceManager::error() будут испущены одновременно.
Примечание: Не удаляйте объект ответа в слоте, подключенном к этому сигналу. Используйте deleteLater() вместо этого.
Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя функции Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:
connect(placeReply, QOverload<QPlaceReply::Error, const QString &>::of(&QPlaceReply::error),
[=](QPlaceReply::Error error, const QString &errorString){ /* ... */ }); 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::error(QPlaceReply::Error, const QString &errorString).
См. также error().
[protected] void QPlaceReply::setFinished(bool finished)
Устанавливает состояние, завершен ли ответ finished или нет. Эта функция не вызывает испускание сигнала finished().
См. также finished().
[virtual] QPlaceReply::Type QPlaceReply::type() const
Возвращает тип ответа.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qplacereply.html
