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 correspondientes operaciones. El QPlaceReply propiamente dicho se utiliza para operaciones que no tienen resultados, es decir, sólo es necesario saber si la operación ha tenido éxito o ha fallado.
La señal finished() se puede utilizar para monitorizar el progreso de una operación. Una vez finalizada una operación, los métodos error() y errorString() proporcionan información sobre si la operación se ha completado con éxito. En caso de éxito, la respuesta contendrá los resultados de esa operación, es decir, cada subclase tendrá funciones apropiadas para recuperar los resultados de una operación.
Véase también QPlaceManager.
Documentación de 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 encontrado el lugar especificado |
QPlaceReply::CategoryDoesNotExistError | 2 | No se ha encontrado la categoría especificada |
QPlaceReply::CommunicationError | 3 | Se ha producido un error en la comunicación con el proveedor de servicios. |
QPlaceReply::ParseError | 4 | La respuesta del proveedor de servicios o un archivo de importación tenía un formato irreconocible. |
QPlaceReply::PermissionsError | 5 | La operación falló debido a permisos insuficientes. |
QPlaceReply::UnsupportedError | 6 | El proveedor de servicios no admite la operación. |
QPlaceReply::BadArgumentError | 7 | . Un parámetro proporcionado no es 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 otras 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 | Se trata de una respuesta para la recuperación de detalles de lugar. |
QPlaceReply::SearchReply | 2 | Se trata de una respuesta para la operación de búsqueda de lugar. |
QPlaceReply::SearchSuggestionReply | 3 | Se trata de una respuesta para una operación de sugerencia de búsqueda. |
QPlaceReply::ContentReply | 4 | Se trata de una respuesta para el contenido asociado a un lugar. |
QPlaceReply::IdReply | 5 | Es una respuesta que devuelve un identificador de un lugar o categoría. Se utiliza normalmente para operaciones de guardar y eliminar lugares o categorías. |
QPlaceReply::MatchReply | 6 | Es una respuesta que devuelve lugares que coinciden con los de otro proveedor. |
Documentación de las funciones miembro
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Construye un objeto de respuesta con la dirección parent.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Destruye el objeto de respuesta.
[virtual slot] void QPlaceReply::abort()
Cancela la operación inmediatamente.
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, esta señal puede no emitirse nunca o emitirse 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: No elimine ni borre posteriormente este objeto de respuesta en la ranura conectada a esta señal. Hágalo sólo en 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 elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
QString QPlaceReply::errorString() const
Devuelve la cadena de error de la respuesta. La cadena de error está pensada para ser utilizada sólo por desarrolladores y no es apta para ser mostrada 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 la respuesta ha terminado de procesarse.
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 elimine este objeto de respuesta en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.
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 error y errorString de la respuesta. Esta función no provoca la emisión de la señal QPlaceReply::errorOccurred(QPlaceReply::Error, const QString &errorString).
Véase también error().
[protected] void QPlaceReply::setFinished(bool finished)
Establece el estado de si la respuesta es finished o no. Esta función no provoca la emisión de 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.
