QPlaceReply Class
La clase `QPlaceReply` gestiona una operación iniciada por una instancia de ` QPlaceManager ` y sirve como clase base para respuestas más especializadas. Más...
| Header: | #include <QPlaceReply> |
| qmake: | QT += location |
| Inherits: | QObject |
| Inherited By: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply, and QPlaceSearchSuggestionReply |
Tipos públicos
| enum | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| enum | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
Funciones públicas
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
Ranuras públicas
| virtual void | abort() |
Señales
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Funciones protegidas
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
Descripción detallada
QPlaceReply y cada una de sus subclases especializadas gestionan el estado y los resultados de sus operaciones correspondientes. La propia clase QPlaceReply se utiliza para operaciones que no tienen resultados, es decir, en las que solo es necesario saber si la operación se ha realizado con éxito o ha fallado.
La señal ` finished()` se puede utilizar para supervisar el progreso de una operación. Una vez completada la operación, los métodos ` error()` y ` errorString()` proporcionan información sobre si la operación se ha completado con éxito. En caso afirmativo, la respuesta contendrá los resultados de dicha operación; es decir, cada subclase dispondrá de las funciones adecuadas para recuperar los resultados de una operación.
Véase también QPlaceManager.
Documentación sobre los tipos de miembros
enum QPlaceReply::Error
Describe un error que se ha producido durante una operación.
| Constante | Valor | Descripción |
|---|---|---|
QPlaceReply::NoError | 0 | No se ha producido ningún error |
QPlaceReply::PlaceDoesNotExistError | 1 | No se ha podido encontrar el lugar especificado |
QPlaceReply::CategoryDoesNotExistError | 2 | No se ha podido encontrar la categoría especificada |
QPlaceReply::CommunicationError | 3 | Se ha producido un error al comunicarse con el proveedor de servicios. |
QPlaceReply::ParseError | 4 | La respuesta del proveedor de servicios o de un archivo de importación tenía un formato no reconocible |
QPlaceReply::PermissionsError | 5 | La operación ha fallado debido a permisos insuficientes. |
QPlaceReply::UnsupportedError | 6 | El proveedor de servicios no admite esta operación. |
QPlaceReply::BadArgumentError | 7 | . Se ha proporcionado un parámetro no válido. |
QPlaceReply::CancelError | 8 | La operación se ha cancelado. |
QPlaceReply::UnknownError | 9 | Se ha producido un error que no encaja en ninguna de las demás categorías. |
enum QPlaceReply::Type
Describe el tipo de respuesta.
| Constante | Valor | Descripción |
|---|---|---|
QPlaceReply::Reply | 0 | Se trata de una respuesta genérica. |
QPlaceReply::DetailsReply | 1 | Esta es una respuesta para la recuperación de detalles de un lugar |
QPlaceReply::SearchReply | 2 | Esta es una respuesta a la operación de búsqueda de un lugar. |
QPlaceReply::SearchSuggestionReply | 3 | Esta es una respuesta a una operación de sugerencia de búsqueda. |
QPlaceReply::ContentReply | 4 | Esta es una respuesta sobre el contenido asociado a un lugar. |
QPlaceReply::IdReply | 5 | Esta es una respuesta que devuelve un identificador de un lugar o una categoría. Se utiliza habitualmente para operaciones de guardado y eliminación de lugares o categorías. |
QPlaceReply::MatchReply | 6 | Esta es una respuesta que devuelve los lugares que coinciden con los de otro proveedor. |
Documentación de las funciones de miembro
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Crea un objeto de respuesta con el ` parent` indicado.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Elimina el objeto de respuesta.
[virtual slot] void QPlaceReply::abort()
Cancela la operación de inmediato.
Véase también aborted().
[signal] void QPlaceReply::aborted()
Esta señal se emite cuando se ha cancelado la operación.
Véase también abort().
[signal] void QPlaceReply::contentUpdated()
Esta señal se emite cuando esta respuesta tiene contenido actualizado disponible. Dependiendo del complemento, es posible que esta señal nunca se emita o que se emita varias veces antes de que se emita QPlaceReply::finished(), ya que algunos backends pueden devolver el contenido solicitado de forma asíncrona e incremental.
Nota: Noutilices «delete» ni «deleteLater» con este objeto de respuesta en la ranura conectada a esta señal. Hazlo únicamente tras la emisión de « QPlaceReply::finished ».
QPlaceReply::Error QPlaceReply::error() const
Devuelve el código de error.
Véase también setError().
[signal] void QPlaceReply::errorOccurred(QPlaceReply::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 destinada a los desarrolladores y no a los usuarios finales.
Esta señal y « QPlaceManager::errorOccurred()» se emitirán al mismo tiempo.
Nota: No elimines este objeto de respuesta en la ranura conectada a esta señal. Utiliza en su lugar deleteLater().
QString QPlaceReply::errorString() const
Devuelve la cadena de error de la respuesta. La cadena de error está destinada exclusivamente a los desarrolladores y no es adecuada para mostrársela a un usuario final.
Si no se ha producido ningún error, la cadena estará vacía.
[signal] void QPlaceReply::finished()
Esta señal se emite cuando ha finalizado el procesamiento de esta respuesta.
Si error() es igual a QPlaceReply::NoError, el procesamiento ha finalizado correctamente.
Esta señal y ` QPlaceManager::finished()` se emitirán al mismo tiempo.
Nota: No elimines este objeto de respuesta en la ranura conectada a esta señal. Utiliza en su lugar ` deleteLater()`.
Véase también setFinished().
bool QPlaceReply::isFinished() const
Devuelve «true» si la respuesta se ha completado.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
Establece los valores de « error » y « errorString » de la respuesta. Esta función no provoca la emisión de la señal « QPlaceReply::errorOccurred » (QPlaceReply::Error, const QString yerrorString).
Véase también error().
[protected] void QPlaceReply::setFinished(bool finished)
Establece si la respuesta es de tipo « finished » o no. Esta función no provoca que se emita la señal « finished()».
Véase también finished().
[virtual] QPlaceReply::Type QPlaceReply::type() const
Devuelve el tipo de la respuesta.
© 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.