En esta página

QIconEngine Class

La clase `QIconEngine` proporciona una clase base abstracta para los renderizadores de ` QIcon `. Más información...

Encabezado: #include <QIconEngine>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

struct ScaledPixmapArgument
enum IconEngineHook { IsNullHook, ScaledPixmapHook }

Funciones públicas

QIconEngine()
virtual ~QIconEngine()
virtual QSize actualSize(const QSize &size, QIcon::Mode mode, QIcon::State state)
virtual void addFile(const QString &fileName, const QSize &size, QIcon::Mode mode, QIcon::State state)
virtual void addPixmap(const QPixmap &pixmap, QIcon::Mode mode, QIcon::State state)
virtual QList<QSize> availableSizes(QIcon::Mode mode = QIcon::Normal, QIcon::State state = QIcon::Off)
virtual QIconEngine *clone() const = 0
virtual QString iconName()
virtual bool isNull()
virtual QString key() const
virtual void paint(QPainter *painter, const QRect &rect, QIcon::Mode mode, QIcon::State state) = 0
virtual QPixmap pixmap(const QSize &size, QIcon::Mode mode, QIcon::State state)
virtual bool read(QDataStream &in)
virtual QPixmap scaledPixmap(const QSize &size, QIcon::Mode mode, QIcon::State state, qreal scale)
virtual void virtual_hook(int id, void *data)
virtual bool write(QDataStream &out) const

Descripción detallada

Un motor de iconos proporciona las funciones de renderizado para un ` QIcon`. Cada icono tiene un motor de iconos correspondiente que se encarga de dibujar el icono con el tamaño, el modo y el estado solicitados.

El icono se representa mediante la función ` paint()`, y además se puede obtener como un mapa de píxeles con la función ` pixmap()` (la implementación por defecto simplemente utiliza ` paint()` para lograrlo). La función ` addPixmap()` se puede utilizar para añadir nuevos mapas de píxeles al motor de iconos, y es utilizada por ` QIcon ` para añadir mapas de píxeles personalizados especializados.

Las funciones paint(), pixmap() y addPixmap() son todas virtuales y, por lo tanto, pueden reimplementarse en subclases de QIconEngine.

Véase también QIconEnginePlugin.

Documentación sobre los tipos de miembros

enum QIconEngine::IconEngineHook

Estos valores de enumeración se utilizan en virtual_hook() para permitir consultas adicionales al motor de iconos sin romper la compatibilidad binaria.

ConstanteValorDescripción
QIconEngine::IsNullHook3Permite consultar si este motor representa un icono nulo. El argumento ` data ` de la función ` virtual_hook()` es un puntero a un valor booleano que puede establecerse en `true` si el icono es nulo. Este valor de enumeración se añadió en Qt 5.7.
QIconEngine::ScaledPixmapHook4Proporciona una forma de obtener un mapa de píxeles escalado según la escala dada (normalmente igual a la relación de píxeles del dispositivo). El argumento ` data ` de la función ` virtual_hook()` es un puntero ` ScaledPixmapArgument ` que contiene tanto los argumentos de entrada como los de salida. Este valor de enumeración se añadió en Qt 5.9.

Véase también virtual_hook().

Documentación de funciones miembro

QIconEngine::QIconEngine()

Crea el motor de iconos.

[virtual noexcept] QIconEngine::~QIconEngine()

Elimina el motor de iconos.

[virtual] QSize QIconEngine::actualSize(const QSize &size, QIcon::Mode mode, QIcon::State state)

Devuelve el tamaño real del icono que el motor proporciona para los valores solicitados de ` size`, ` mode ` y ` state`. La implementación predeterminada devuelve el valor dado de ` size`.

El tamaño devuelto se expresa en píxeles independientes del dispositivo (esto es relevante para mapas de píxeles de alta resolución).

[virtual] void QIconEngine::addFile(const QString &fileName, const QSize &size, QIcon::Mode mode, QIcon::State state)

Llamada por QIcon::addFile(). Añade un mapa de píxeles especializado a partir del archivo con los parámetros indicados: fileName, size, mode y state. El motor predeterminado basado en mapas de píxeles almacena los nombres de los archivos proporcionados y carga los mapas de píxeles cuando es necesario, en lugar de utilizar mapas de píxeles escalados, si el tamaño de un mapa de píxeles coincide con el tamaño del icono solicitado. Los motores de iconos personalizados que implementan formatos vectoriales escalables pueden ignorar libremente cualquier archivo adicional.

[virtual] void QIconEngine::addPixmap(const QPixmap &pixmap, QIcon::Mode mode, QIcon::State state)

Llamado por QIcon::addPixmap(). Añade un motor de iconos especializado pixmap para los valores proporcionados mode y state. El motor predeterminado, basado en mapas de píxeles, almacena cualquier mapa de píxeles proporcionado y los utiliza en lugar de los mapas de píxeles escalados si el tamaño de un mapa de píxeles coincide con el tamaño del icono solicitado. Los motores de iconos personalizados que implementan formatos vectoriales escalables pueden ignorar cualquier mapa de píxeles adicional.

[virtual] QList<QSize> QIconEngine::availableSizes(QIcon::Mode mode = QIcon::Normal, QIcon::State state = QIcon::Off)

Devuelve los tamaños de todas las imágenes que contiene el motor para las direcciones específicas mode y state.

[pure virtual] QIconEngine *QIconEngine::clone() const

Reimplementa este método para que devuelva un clon de este motor de iconos.

[virtual] QString QIconEngine::iconName()

Devuelve el nombre utilizado para crear el motor, si está disponible.

[virtual] bool QIconEngine::isNull()

Devuelve «true» si este motor de iconos representa un ` QIcon` nulo.

Nota: Si el motor de iconos no reimplementa esta función, el trabajo real lo realiza el método virtual_hook(), por lo que este método depende de la compatibilidad del motor de iconos y es posible que no funcione con todos los motores de iconos.

[virtual] QString QIconEngine::key() const

Devuelve una clave que identifica este motor de iconos.

[pure virtual] void QIconEngine::paint(QPainter *painter, const QRect &rect, QIcon::Mode mode, QIcon::State state)

Utiliza el objeto ` painter ` proporcionado para dibujar el icono con los valores requeridos ` mode ` y ` state ` dentro del rectángulo ` rect`.

[virtual] QPixmap QIconEngine::pixmap(const QSize &size, QIcon::Mode mode, QIcon::State state)

Devuelve el icono como un mapa de píxeles con los parámetros obligatorios « size », « mode » y « state ». La implementación por defecto crea un nuevo mapa de píxeles y llama a la función « paint()» para rellenarlo.

[virtual] bool QIconEngine::read(QDataStream &in)

Lee el contenido del motor de iconos desde QDataStream in . Devuelve «true» si se ha leído el contenido; en caso contrario, devuelve « false ».

QIconEngineLa implementación predeterminada siempre devuelve «false».

[virtual] QPixmap QIconEngine::scaledPixmap(const QSize &size, QIcon::Mode mode, QIcon::State state, qreal scale)

Devuelve un mapa de píxeles para los valores proporcionados de ` size`, ` mode`, ` state ` y ` scale`.

El argumento scale suele ser igual a la relación de píxeles del dispositivo de la pantalla. El tamaño se expresa en píxeles independientes del dispositivo.

Nota: Si el motor de iconos no reimplementa esta función, el trabajo real lo realiza el método virtual_hook(), por lo que este método depende de la compatibilidad del motor de iconos y puede que no funcione con todos ellos.

Nota: Algunos motores pueden convertir scale a un entero.

Véase también ScaledPixmapArgument.

[virtual] void QIconEngine::virtual_hook(int id, void *data)

Método adicional que permite ampliar la clase ` QIconEngine ` sin añadir nuevos métodos virtuales (y sin romper la compatibilidad binaria). La acción y el formato reales de ` data ` dependen del argumento ` id `, que en realidad es una constante de la enumeración ` IconEngineHook `.

Véase también IconEngineHook.

[virtual] bool QIconEngine::write(QDataStream &out) const

Escribe el contenido de este motor en QDataStream out . Devuelve true si se ha escrito el contenido; en caso contrario, devuelve false.

QIconEngineLa implementación por defecto siempre 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.