Класс QGeoRouteReply

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

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

Общественные типы

Общественные функции

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

Сигналы

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

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

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

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

• 1 свойство, унаследованное от QObject
• 1 общественный слот, унаследованный от QObject
• 1 общественная переменная, унаследованная от QObject
• 10 статических общественных членов, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

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

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

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

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

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

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

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

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

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

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

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

Создает ответ о маршруте с заданной ошибкой и errorString и указанным parent.

[protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)

Создает объект ответа маршрута на основе request с указанным parent.

[virtual] QGeoRouteReply::~QGeoRouteReply()

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

[virtual] void QGeoRouteReply::abort()

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

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

[signal] void QGeoRouteReply::aborted()

Этот сигнал излучается, когда операция была отменена.

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

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

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

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

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

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

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

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

[signal] 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(QGeoRouteReply::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().