En esta página

QPlaceIcon Class

La clase QPlaceIcon representa un icono. Más información...

Header: #include <QPlaceIcon>
qmake: QT += location

Propiedades

Funciones públicas

QPlaceIcon()
QPlaceIcon(const QPlaceIcon &other)
QPlaceIcon(QPlaceIcon &&other)
~QPlaceIcon()
bool isEmpty() const
QPlaceManager *manager() const
QVariantMap parameters() const
void setManager(QPlaceManager *manager)
void setParameters(const QVariantMap &parameters)
QUrl url(const QSize &size = QSize()) const
QPlaceIcon &operator=(const QPlaceIcon &other)

Miembros públicos estáticos

const QString SingleUrl
bool operator!=(const QPlaceIcon &lhs, const QPlaceIcon &rhs)
bool operator==(const QPlaceIcon &lhs, const QPlaceIcon &rhs)

Descripción detallada

El uso habitual de un icono consiste en utilizar la función ` url()` para especificar el tamaño de icono preferido.

QUrl iconSourceUrl = place.icon().url(QSize(32,32));

//A default icon may also be requested like so
iconSourceUrl = place.icon().url();

Los iconos suelen depender del backend; si el backend de un gestor no admite un tamaño determinado, se devuelve la URL del icono que más se aproxime a esos parámetros.

La clase de iconos también cuenta con un conjunto de parámetros clave-valor. La clave concreta que hay que utilizar depende del complemento que se esté utilizando. Estos parámetros influyen en la URL del icono que devuelve el gestor y también pueden utilizarse para especificar las ubicaciones de las URL de los iconos al guardarlos.

Si solo hay una imagen para un icono, se puede utilizar « QPlaceIcon::SingleUrl » como clave de parámetro con « QUrl » como valor asociado. Si se establece esta clave, la función « url()» siempre devolverá la URL especificada y no se remitirá a ningún gestor.

Documentación de propiedades

manager : QPlaceManager*

Esta propiedad contiene el gestor de este icono.

Funciones de acceso:

QPlaceManager *manager() const
void setManager(QPlaceManager *manager)

parameters : QVariantMap

Esta propiedad contiene el conjunto de parámetros del icono que son específicos del gestor o del complemento.

Funciones de acceso:

QVariantMap parameters() const
void setParameters(const QVariantMap &parameters)

Documentación de las funciones de miembro

QPlaceIcon::QPlaceIcon()

Crea un icono.

[noexcept] QPlaceIcon::QPlaceIcon(const QPlaceIcon &other)

Crea una copia de other.

[constexpr noexcept default] QPlaceIcon::QPlaceIcon(QPlaceIcon &&other)

Crea una instancia de ` QPlaceIcon` mediante la construcción «move».

[noexcept] QPlaceIcon::~QPlaceIcon()

Elimina el icono.

bool QPlaceIcon::isEmpty() const

Devuelve un valor booleano que indica si todos los campos del icono están vacíos o no.

QPlaceManager *QPlaceIcon::manager() const

Devuelve el gestor al que está asociado este icono.

Nota: Funcióngetter para la propiedad «manager».

Véase también setManager().

QVariantMap QPlaceIcon::parameters() const

Devuelve un conjunto de parámetros para el icono específicos del gestor o del complemento. El gestor utiliza estos parámetros para devolver la URL adecuada cuando se llama a url() y para especificar las ubicaciones en las que se deben guardar los iconos.

Consulta la documentación del complemento para saber qué parámetros son compatibles y cómo deben utilizarse.

Nota: Funcióngetter para los parámetros de la propiedad.

Véase también setParameters().

void QPlaceIcon::setManager(QPlaceManager *manager)

Establece la propiedad ` manager ` a la que está asociado este icono. El icono no toma posesión del puntero.

Nota: Funciónde asignación para la propiedad manager.

Véase también manager().

void QPlaceIcon::setParameters(const QVariantMap &parameters)

Establece los parámetros del icono en parameters.

Nota: Funciónde asignación para la propiedad parameters.

Véase también parameters().

[invokable] QUrl QPlaceIcon::url(const QSize &size = QSize()) const

Devuelve la URL de un icono según el valor de « size » proporcionado.

Si no se ha asignado ningún gestor al icono y los parámetros no contienen la clave « QPlaceIcon::SingleUrl », se devuelve un objeto « QUrl » creado por defecto.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[noexcept] QPlaceIcon &QPlaceIcon::operator=(const QPlaceIcon &other)

Asigna « other » a este icono y devuelve una referencia a dicho icono.

Documentación sobre variables de miembro

const QString QPlaceIcon::SingleUrl

Clave de parámetro para un icono que solo tiene una URL de imagen.

El valor del parámetro que se debe utilizar con esta clave es « QUrl ». Un icono con este parámetro configurado siempre devolverá la URL especificada, independientemente del tamaño solicitado, cuando se llame a ` url()`.

Elementos relacionados para no miembros

[noexcept] bool operator!=(const QPlaceIcon &lhs, const QPlaceIcon &rhs)

Devuelve «true» si « lhs » no es igual a « rhs »; en caso contrario, devuelve «false».

[noexcept] bool operator==(const QPlaceIcon &lhs, const QPlaceIcon &rhs)

Devuelve «true» si « lhs » es igual a « rhs »; en caso contrario, devuelve «false».

© 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.