En esta página

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.

ConstanteValorDescripción
QPlaceReply::NoError0No se ha producido ningún error
QPlaceReply::PlaceDoesNotExistError1No se ha podido encontrar el lugar especificado
QPlaceReply::CategoryDoesNotExistError2No se ha podido encontrar la categoría especificada
QPlaceReply::CommunicationError3Se ha producido un error al comunicarse con el proveedor de servicios.
QPlaceReply::ParseError4La respuesta del proveedor de servicios o de un archivo de importación tenía un formato no reconocible
QPlaceReply::PermissionsError5La operación ha fallado debido a permisos insuficientes.
QPlaceReply::UnsupportedError6El proveedor de servicios no admite esta operación.
QPlaceReply::BadArgumentError7. Se ha proporcionado un parámetro no válido.
QPlaceReply::CancelError8La operación se ha cancelado.
QPlaceReply::UnknownError9Se ha producido un error que no encaja en ninguna de las demás categorías.

enum QPlaceReply::Type

Describe el tipo de respuesta.

ConstanteValorDescripción
QPlaceReply::Reply0Se trata de una respuesta genérica.
QPlaceReply::DetailsReply1Esta es una respuesta para la recuperación de detalles de un lugar
QPlaceReply::SearchReply2Esta es una respuesta a la operación de búsqueda de un lugar.
QPlaceReply::SearchSuggestionReply3Esta es una respuesta a una operación de sugerencia de búsqueda.
QPlaceReply::ContentReply4Esta es una respuesta sobre el contenido asociado a un lugar.
QPlaceReply::IdReply5Esta 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::MatchReply6Esta 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.