Класс QPlaceReply
Класс QPlaceReply управляет операцией, запущенной экземпляром QPlaceManager, и служит базовым классом для более специализированных ответов. Подробнее...
| Заголовок: | #include <QPlaceReply> |
| qmake: | QT += location |
| С момента: | Qt 5.6 |
| Наследует: | QObject |
| Наследуется от: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply и QPlaceSearchSuggestionReply |
Открытые типы
| перечисление | Ошибка { НетОшибки, ОшибкаНесуществующегоМестоположения, ОшибкаНесуществующейКатегории, ОшибкаСвязи, ..., НеизвестнаяОшибка } |
| перечисление | Тип { Ответ, ОтветПодробностей, ОтветПоиска, ОтветПредложенияПоиска, ..., ОтветСовпадений } |
Открытые функции
| QPlaceReply(QObject *parent = nullptr) | |
| виртуальный | ~QPlaceReply() |
| QPlaceReply::Ошибка | ошибка() const |
| QString | ошибкаСтрока() const |
| bool | завершён() const |
| виртуальный QPlaceReply::Тип | тип() const |
- 31 открытая функция, унаследованная от QObject
Открытые слоты
| виртуальный void | прервать() |
- 1 открытый слот, унаследованный от QObject
Сигналы
| void | прерван() |
| void | содержаниеОбновлено() |
| void | ошибка(QPlaceReply::Ошибка ошибка, const QString &ошибкаСтрока = QString()) |
| void | закончен() |
- 2 сигнала, унаследованные от QObject
Статические открытые члены
| const QMetaObject | staticMetaObject |
- 9 статических открытых членов, унаследованных от QObject
Защищенные функции
| void | установитьОшибку(QPlaceReply::Ошибка ошибка, const QString &ошибкаСтрока) |
| void | установитьЗавершен(bool завершён) |
- 9 защищенных функций, унаследованных от QObject
Защищенные переменные
| QPlaceReplyPrivate * | d_ptr |
Дополнительные унаследованные члены
- 1 свойство, унаследованное от QObject
Подробное описание
Класс QPlaceReply управляет операцией, запущенной экземпляром QPlaceManager, и служит базовым классом для более специализированных ответов.
Класс QPlaceReply и каждый из его специализированных подклассов управляют состоянием и результатами соответствующих операций. Сам QPlaceReply используется для операций, у которых нет результатов, то есть достаточно знать, завершилась ли операция успешно или нет.
Сигнал закончен() может использоваться для отслеживания прогресса операции. После завершения операции методы ошибка() и ошибкаСтрока() предоставляют информацию о том, завершилась ли операция успешно. При успешном завершении ответ будет содержать результаты этой операции, то есть каждый подкласс будет иметь соответствующие функции для извлечения результатов операции.
См. также QPlaceManager.
Документация по типам членов
перечисление QPlaceReply::Ошибка
Описывает ошибку, возникшую во время операции.
| Постоянная | Значение | Описание |
|---|---|---|
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::Тип
Описывает тип ответа.
| Постоянная | Значение | Описание |
|---|---|---|
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::прервать()
Отменяет операцию немедленно.
См. также прерван().
[signal] void QPlaceReply::aborted()
Этот сигнал излучается, когда операция была отменена.
Эта функция была представлена в Qt 5.9.
См. также abort().
[signal] void QPlaceReply::contentUpdated()
Этот сигнал излучается, когда в этом ответе обновлено доступное содержимое. В зависимости от плагина, этот сигнал может никогда не излучаться или излучаться несколько раз до того, как излучится QPlaceReply::finished(), так как некоторые бэкэнды способны возвращать запрашиваемое содержимое асинхронно и по частям.
Примечание: Не удаляйте и не используйте deleteLater этот объект ответа в слоте, подключенном к этому сигналу. Делайте это только при QPlaceReply::finished.
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/qt-5.12/qplacereply.html
