En esta página

QPlaceIcon Class

La clase QPlaceIcon representa un icono. Más...

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

Propiedades

Funciones públicas

QPlaceIcon()
QPlaceIcon(const 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 típico de un icono es utilizar la función url() para especificar un 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 icono también tiene un conjunto clave-valor de parámetros. La clave exacta que hay que utilizar depende del plugin que se utilice. 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 sólo 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, entonces la función url() siempre devolverá la URL especificada y no diferirá 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 plugin.

Funciones de acceso:

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

Documentación de funciones miembro

QPlaceIcon::QPlaceIcon()

Construye un icono.

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

Construye una copia de other.

[noexcept] QPlaceIcon::~QPlaceIcon()

Destruye el icono.

bool QPlaceIcon::isEmpty() const

Devuelve un 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ón Getter para el gestor de propiedades.

Véase también setManager().

QVariantMap QPlaceIcon::parameters() const

Devuelve un conjunto de parámetros para el icono que son específicos del gestor/plugin. Estos parámetros son utilizados por el gestor para devolver la URL apropiada cuando se llama a url() y para especificar las ubicaciones donde guardar los iconos.

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

Nota: Función Getter para parámetros de propiedades.

Véase también setParameters().

void QPlaceIcon::setManager(QPlaceManager *manager)

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

Nota: Función setter 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ón Setter para la propiedad parameters.

Véase también parameters().

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

Devuelve una URL de icono según el size dado.

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

Nota: Esta función puede invocarse 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 este icono.

Documentación de la variable miembro

const QString QPlaceIcon::SingleUrl

Clave de parámetro para un icono que sólo tiene una URL de imagen.

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

No miembros relacionados

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