Класс QGeoRouteReply

Класс QGeoRouteReply управляет операцией, запущенной экземпляром QGeoRoutingManager. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Функции публичного доступа

• 32 функции публичного доступа унаследованы от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Защищенные функции

• 9 защищенных функций унаследованы от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 1 публичный слот унаследован от QObject
• 11 статических публичных членов унаследованы от QObject

Подробное описание

Класс QGeoRouteReply управляет операцией, запущенной экземпляром QGeoRoutingManager.

Экземпляры QGeoRouteReply управляют состоянием и результатами этих операций.

Методы isFinished(), error() и errorString() предоставляют информацию о завершении операции и ее успешности.

Сигналы finished() и error(QGeoRouteReply::Ошибка,QString) могут использоваться для отслеживания выполнения операции.

Возможно, что недавно созданный QGeoRouteReply может быть в завершенном состоянии, чаще всего из-за возникшей ошибки. Поскольку такой экземпляр никогда не будет испускать сигналы finished() или error(QGeoRouteReply::Ошибка,QString), важно проверить результат isFinished() перед подключением к сигналам. Документация QGeoRoutingManager демонстрирует, как это можно сделать.

Если операция завершилась успешно, результаты можно получить с помощью routes().

Документация по типам членов

Перечисление QGeoRouteReply::Ошибка

Описывает ошибку, которая помешала завершению операции.

Документация по функциям членов

QGeoRouteReply::QGeoRouteReply(Ошибка error, const QString &errorString, QObject *parent = Q_NULLPTR)

Конструктор объекта ответа маршрутизации с заданной ошибкой и описанием ошибки и указанным родителем.

QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = Q_NULLPTR)

Конструирует объект ответа маршрутизации на основе request с указанным родителем.

QGeoRouteReply::~QGeoRouteReply()

Уничтожает этот объект ответа маршрутизации.

void QGeoRouteReply::abort()

Немедленно отменяет операцию.

Это ничего не сделает, если ответ уже завершен.

void QGeoRouteReply::aborted()

Этот сигнал испускается при отмене операции.

Эта функция была введена в Qt 5.9.

См. также abort().

void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)

Добавляет список маршрутов к существующему списку.

Ошибка QGeoRouteReply::error() const

Возвращает состояние ошибки этого ответа.

Если результат равен QGeoRouteReply::НетОшибки, ошибка не произошла.

См. также setError().

void QGeoRouteReply::error(QGeoRouteReply::Ошибка error, const QString &errorString = QString())

Этот сигнал испускается при обнаружении ошибки в обработке этого ответа. Скорее всего, последует сигнал finished().

Ошибка будет описана кодом ошибки error. Если errorString не пуста, она будет содержать текстовое описание ошибки.

Этот сигнал и QGeoRoutingManager::error() будут испущены одновременно.

Примечание: Не удаляйте этот объект ответа в слоте, подключенном к этому сигналу. Используйте deleteLater() вместо этого.

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя функции Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(geoRouteReply, QOverload<QGeoRouteReply::Error, const QString &>::of(&QGeoRouteReply::error),
    [=](QGeoRouteReply::Error error, const QString &errorString){ /* ... */ });

QString QGeoRouteReply::errorString() const

Возвращает текстовое представление состояния ошибки этого ответа.

Если ошибка не произошла, это вернет пустую строку. Возможно, произошла ошибка, для которой нет связанного текстового представления, в этом случае это также вернет пустую строку.

Чтобы определить, произошла ли ошибка, проверьте, равен ли QGeoRouteReply::error() значению QGeoRouteReply::NoError.

[signal] void QGeoRouteReply::finished()

Этот сигнал испускается, когда этот ответ завершил обработку.

Если error() равно QGeoRouteReply::NoError, то обработка завершилась успешно.

Этот сигнал и QGeoRoutingManager::finished() будут испущены одновременно.

Примечание: Не удаляйте этот объект ответа в слоте, подключенном к этому сигналу. Используйте deleteLater() вместо этого.

См. также setFinished().

bool QGeoRouteReply::isFinished() const

Возвращает true, если операция завершилась успешно или столкнулась с ошибкой, которая привела к остановке операции.

QGeoRouteRequest QGeoRouteReply::request() const

Возвращает запрос маршрута, который задал маршрут.

QList<QGeoRoute> QGeoRouteReply::routes() const

Возвращает список маршрутов, которые были запрошены.

См. также setRoutes().

[protected] void QGeoRouteReply::setError(Error error, const QString &errorString)

Устанавливает состояние ошибки этого ответа на error и текстовое представление ошибки на errorString.

Это также приведет к испусканию сигналов error() и finished(), в этом порядке.

См. также error().

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

Устанавливает, завершен ли этот ответ, на finished.

Если finished имеет значение true, это вызовет испускание сигнала finished().

Если операция завершилась успешно, необходимо вызвать QGeoRouteReply::setRoutes() перед этой функцией. Если произошла ошибка, вместо этого следует использовать QGeoRouteReply::setError().

См. также finished().

[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)

Устанавливает список маршрутов в ответе на routes.

См. также routes().