QGeoRouteReply Class
La clase QGeoRouteReply gestiona una operación iniciada por una instancia de QGeoRoutingManager. Más...
| Header: | #include <QGeoRouteReply> |
| qmake: | QT += location |
| Inherits: | QObject |
Tipos Públicos
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, UnknownError } |
Funciones Públicas
| QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr) | |
| virtual | ~QGeoRouteReply() |
| virtual void | abort() |
| QGeoRouteReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| QGeoRouteRequest | request() const |
| QList<QGeoRoute> | routes() const |
Señales
| void | aborted() |
| void | errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Funciones protegidas
| QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr) | |
| void | addRoutes(const QList<QGeoRoute> &routes) |
| void | setError(QGeoRouteReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setRoutes(const QList<QGeoRoute> &routes) |
Descripción Detallada
Las instancias de QGeoRouteReply gestionan el estado y los resultados de estas operaciones.
Los métodos isFinished(), error() y errorString() proporcionan información sobre si la operación ha finalizado y si lo ha hecho con éxito.
Las señales finished() y errorOccurred(QGeoRouteReply::Error,QString) pueden utilizarse para controlar el progreso de la operación.
Es posible que un QGeoRouteReply recién creado se encuentre en un estado finalizado, más comúnmente porque se ha producido un error. Dado que una instancia de este tipo nunca emitirá las señales finished() o errorOccurred(QGeoRouteReply::Error,QString), es importante comprobar el resultado de isFinished() antes de realizar las conexiones con las señales. La documentación de QGeoRoutingManager muestra cómo hacerlo.
Si la operación se completa con éxito, se podrá acceder a los resultados con routes().
Documentación de los tipos de miembros
enum QGeoRouteReply::Error
Describe un error que ha impedido completar la operación.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteReply::NoError | 0 | No se ha producido ningún error. |
QGeoRouteReply::EngineNotSetError | 1 | El gestor de enrutamiento utilizado no tenía asociada una instancia de QGeoRoutingManagerEngine. |
QGeoRouteReply::CommunicationError | 2 | Se ha producido un error durante la comunicación con el proveedor de servicios. |
QGeoRouteReply::ParseError | 3 | La respuesta del proveedor de servicios tenía un formato irreconocible. |
QGeoRouteReply::UnsupportedOptionError | 4 | La operación solicitada o una de las opciones de la operación no son compatibles con el proveedor de servicios. |
QGeoRouteReply::UnknownError | 5 | Se ha producido un error que no encaja en ninguna de las otras categorías. |
Documentación de las funciones miembro
[explicit protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)
Construye un objeto de respuesta de ruta basado en request, con el parent especificado.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
Construye una respuesta de ruta con un error y errorString dados y el parent especificado.
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
Destruye este objeto de respuesta de ruta.
[virtual] void QGeoRouteReply::abort()
Cancela la operación inmediatamente.
Esto no hará nada si la respuesta ha finalizado.
[signal] void QGeoRouteReply::aborted()
Esta señal se emite cuando se ha cancelado la operación.
Véase también abort().
[protected] void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)
Añade la lista de routes a la lista existente.
QGeoRouteReply::Error QGeoRouteReply::error() const
Devuelve el estado de error de esta respuesta.
Si el resultado es QGeoRouteReply::NoError entonces no se ha producido ningún error.
Véase también setError().
[signal] void QGeoRouteReply::errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString())
Esta señal se emite cuando se ha detectado un error en el procesamiento de esta respuesta. Probablemente le seguirá la señal finished() .
El error se describirá mediante el código de error error. Si errorString no está vacío, contendrá una descripción textual del error.
Esta señal y QGeoRoutingManager::errorOccurred() se emitirán al mismo tiempo.
Nota: No elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
QString QGeoRouteReply::errorString() const
Devuelve la representación textual del estado de error de esta respuesta.
Si no se ha producido ningún error, devolverá una cadena vacía. Es posible que se haya producido un error que no tenga representación textual asociada, en cuyo caso también devolverá una cadena vacía.
Para determinar si se ha producido un error, compruebe si QGeoRouteReply::error() es igual a QGeoRouteReply::NoError.
[signal] void QGeoRouteReply::finished()
Esta señal se emite cuando la respuesta ha terminado de procesarse.
Si error() es igual a QGeoRouteReply::NoError, el procesamiento ha finalizado correctamente.
Esta señal y QGeoRoutingManager::finished() se emitirán al mismo tiempo.
Nota: No elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
Véase también setFinished().
bool QGeoRouteReply::isFinished() const
Devuelve true si la operación se ha completado con éxito o ha encontrado un error que ha provocado la detención de la operación.
QGeoRouteRequest QGeoRouteReply::request() const
Devuelve la solicitud de ruta que especificó la ruta.
QList<QGeoRoute> QGeoRouteReply::routes() const
Devuelve la lista de rutas solicitadas.
Véase también setRoutes().
[protected] void QGeoRouteReply::setError(QGeoRouteReply::Error error, const QString &errorString)
Establece el estado de error de esta respuesta en error y la representación textual del error en errorString.
Esto también hará que se emitan las señales errorOccurred() y finished(), en ese orden.
Véase también error().
[protected] void QGeoRouteReply::setFinished(bool finished)
Establece si esta respuesta ha terminado o no en finished.
Si finished es verdadero, se emitirá la señal finished().
Si la operación se completó con éxito, QGeoRouteReply::setRoutes() debe ser llamado antes de esta función. Si se ha producido un error, debe utilizarse QGeoRouteReply::setError() en su lugar.
Véase también finished().
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
Establece la lista de rutas en la respuesta a routes.
Véase también routes().
© 2026 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.
