En esta página

QIcon Class

La clase QIcon ofrece iconos escalables en diferentes modos y estados. Más información...

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

Tipos públicos

enum Mode { Normal, Disabled, Active, Selected }
enum State { On, Off }
(since 6.7) enum class ThemeIcon { AddressBookNew, ApplicationExit, AppointmentNew, CallStart, CallStop, …, WeatherStorm }

Funciones públicas

QIcon()
QIcon(QIconEngine *engine)
QIcon(const QPixmap &pixmap)
QIcon(const QString &fileName)
QIcon(const QIcon &other)
QIcon(QIcon &&other)
~QIcon()
QSize actualSize(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const
void addFile(const QString &fileName, const QSize &size = QSize(), QIcon::Mode mode = Normal, QIcon::State state = Off)
void addPixmap(const QPixmap &pixmap, QIcon::Mode mode = Normal, QIcon::State state = Off)
QList<QSize> availableSizes(QIcon::Mode mode = Normal, QIcon::State state = Off) const
qint64 cacheKey() const
bool isMask() const
bool isNull() const
QString name() const
void paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const
void paint(QPainter *painter, int x, int y, int w, int h, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QPixmap pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QPixmap pixmap(int extent, QIcon::Mode mode = Normal, QIcon::State state = Off) const
(since 6.0) QPixmap pixmap(const QSize &size, qreal devicePixelRatio, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QPixmap pixmap(int w, int h, QIcon::Mode mode = Normal, QIcon::State state = Off) const
void setIsMask(bool isMask)
void swap(QIcon &other)
operator QVariant() const
QIcon &operator=(QIcon &&other)
QIcon &operator=(const QIcon &other)

Miembros públicos estáticos

QStringList fallbackSearchPaths()
QString fallbackThemeName()
QIcon fromTheme(const QString &name)
(since 6.7) QIcon fromTheme(QIcon::ThemeIcon icon)
(since 6.7) QIcon fromTheme(QIcon::ThemeIcon icon, const QIcon &fallback)
QIcon fromTheme(const QString &name, const QIcon &fallback)
bool hasThemeIcon(const QString &name)
(since 6.7) bool hasThemeIcon(QIcon::ThemeIcon icon)
void setFallbackSearchPaths(const QStringList &paths)
void setFallbackThemeName(const QString &name)
void setThemeName(const QString &name)
void setThemeSearchPaths(const QStringList &paths)
QString themeName()
QStringList themeSearchPaths()
QDataStream &operator<<(QDataStream &stream, const QIcon &icon)
QDataStream &operator>>(QDataStream &stream, QIcon &icon)

Descripción detallada

Un QIcon puede generar mapas de píxeles más pequeños, más grandes, activos y desactivados a partir del conjunto de mapas de píxeles que se le proporcione. Los componentes de la interfaz de usuario de Qt utilizan dichos mapas de píxeles para mostrar un icono que representa una acción concreta.

Creación de un icono a partir de archivos de imagen

La forma más sencilla de crear un QIcon es a partir de uno o varios archivos de imagen o recursos. Por ejemplo:

QToolButton *button = new QToolButton;
button->setIcon(QIcon("open.png"));

QIcon puede almacenar varias imágenes para diferentes estados, y Qt seleccionará la imagen que mejor se ajuste al estado actual de la acción.

QIcon openIcon("open.png");
openIcon.addFile("open-disabled.png", size ,QIcon::Disabled);

Qt generará los estilos y tamaños de icono necesarios cuando sea preciso; por ejemplo, el mapa de píxeles para el estado « QIcon::Disabled » podría generarse atenuando uno de los mapas de píxeles proporcionados.

Para borrar el icono, basta con establecer un icono nulo en su lugar:

button->setIcon(QIcon());

Utiliza las funciones ` QImageReader::supportedImageFormats()` y ` QImageWriter::supportedImageFormats()` para obtener una lista completa de los formatos de archivo compatibles.

Nota: Si se utiliza un archivo de imagen SVG, asegúrate de añadirlo antes que cualquier archivo que no sea SVG, para que se seleccione el « icon engine » correcto.

Creación de un icono a partir de un tema o una biblioteca de iconos

La forma más cómoda de crear un icono es utilizando la función de fábrica fromTheme(). Qt implementa el acceso a la biblioteca de iconos nativa en las plataformas que admiten la especificación Freedesktop Icon Theme.

Las aplicaciones pueden utilizar la misma especificación de temas para proporcionar su propia biblioteca de iconos. A continuación se muestra un ejemplo de descripción de un tema y la estructura de directorios correspondiente para los archivos de imagen.

Desde Qt 6.7, Qt también proporciona acceso a la biblioteca de iconos nativa en macOS, iOS y Windows 10 y 11. En Android, Qt puede acceder a los iconos del sistema de diseño Material siempre que la fuente MaterialIcons-Regular esté disponible en el sistema o se incluya como recurso en :/qt-project.org/icons/MaterialIcons-Regular.ttf junto con la aplicación.

QIcon undoicon = QIcon::fromTheme(QIcon::ThemeIcon::EditUndo);

Desde Qt 6.9, Qt puede generar iconos a partir de glifos con nombre en una fuente de iconos disponible. Establece el ` theme name ` en el nombre de la familia de la fuente y utiliza ` fromTheme()` con el nombre del glifo.

QIcon::setThemeName("Material Symbols Outlined");
QIcon muteIcon = QIcon::fromTheme(u"volume_off"_s);

La fuente de iconos puede estar instalada en el sistema o incluirse como un recurso « application font ».

Motores de iconos

Internamente, QIcon instancía un motor de iconos ( icon engine ) para gestionar y renderizar las imágenes de los iconos. El tipo de motor de iconos viene determinado por el primer archivo, mapa de píxeles o tema añadido a un objeto QIcon. Los archivos o mapas de píxeles adicionales serán gestionados por el mismo motor.

Los motores de iconos difieren en la forma en que gestionan y representan los iconos. El motor predeterminado, basado en mapas de píxeles, solo maneja imágenes fijas, mientras que el módulo QtSvg proporciona un motor de iconos capaz de volver a representar los archivos de gráficos vectoriales proporcionados al tamaño solicitado para obtener una mejor calidad. Los motores de iconos de tema, por lo general, solo proporcionan imágenes de la biblioteca de iconos nativa de la plataforma e ignoran cualquier archivo o mapa de píxeles añadido.

Además, es posible proporcionar motores de iconos personalizados. Esto permite a las aplicaciones personalizar todos los aspectos de los iconos generados. Con QIconEnginePlugin es posible registrar diferentes motores de iconos para distintas extensiones de archivo, lo que permite a terceros proporcionar motores de iconos adicionales a los incluidos con Qt.

Uso de QIcon en la interfaz de usuario

Si creas tus propios widgets que tengan la opción de establecer un pequeño mapa de píxeles, considera la posibilidad de permitir que se establezca un QIcon para ese mapa de píxeles. La clase de Qt QToolButton es un ejemplo de este tipo de widget.

Proporcione un método para establecer un QIcon y dibuje el QIcon con paint, eligiendo los parámetros adecuados en función del estado actual de su widget. Por ejemplo:

void MyWidget::drawIcon(QPainter *painter, const QRect &rect)
{
    icon.paint(painter, rect, Qt::AlignCenter, isEnabled() ? QIcon::Normal
                                                           : QIcon::Disabled,
                                               isChecked() ? QIcon::On
                                                           : QIcon::Off);
}

Cuando se recupera un mapa de píxeles mediante `pixmap(QSize, Mode, State)` y no se ha añadido ningún mapa de píxeles para ese tamaño, modo y estado concretos con ` addFile()` o ` addPixmap()`, entonces `QIcon` generará uno sobre la marcha. Esta generación de mapas de píxeles se produce en un ` QIconEngine`. El motor predeterminado reduce la escala de los mapas de píxeles si es necesario, pero nunca la aumenta, y utiliza el estilo actual para calcular el aspecto desactivado.

También puede utilizar el modo Active, por ejemplo, haciendo que su widget se Active cuando el ratón se sitúe sobre él (véase QWidget::enterEvent()), mientras se mantiene pulsado el botón del ratón a la espera de que se suelte para activar la función, o cuando sea el elemento seleccionado actualmente. Si el widget se puede activar o desactivar, se puede utilizar el modo «On» para dibujar un icono diferente.

Los QIcons generados a partir de la biblioteca de iconos nativa, o de una fuente de iconos, utilizan el mismo glifo tanto para el estado « On » como para el estado « Off » del icono. Las aplicaciones pueden cambiar el icono en función del estado del control de la interfaz de usuario o de la acción correspondiente. En una aplicación « Qt Quick », esto se puede hacer mediante un enlace.

ToolButton {
    id: muteButton
    checkable: true
    icon.name: checked ? "volume_off" : "volume_up"
}

QIcon

Nota: QIcon necesita una instancia de QGuiApplication antes de que se cree el icono.

Iconos de alta resolución (DPI)

Los iconos proporcionados por la biblioteca de iconos nativa, o generados a partir del glifo de una fuente de iconos, suelen basarse en gráficos vectoriales y se representarán automáticamente con la resolución adecuada.

Si se proporcionan archivos de imagen propios mediante addFile(), QIcon utilizará "@nx" high DPI syntax de Qt. Esto resulta útil si se dispone de una estructura de directorios personalizada y no se sigue la especificación de temas de iconos de Freedesktop.

Si se proporciona un tema de aplicación, es necesario seguir la especificación de temas de iconos para indicar qué archivos se deben utilizar para las diferentes resoluciones. Para que QIcon utilice la versión de alta resolución (DPI) de una imagen, añade una entrada adicional al archivo index.theme correspondiente:

[Icon Theme]
Name=Test
Comment=Test Theme

Directories=32x32/actions,32x32@2/actions

[32x32/actions]
Size=32
Context=Actions
Type=Fixed

# High DPI version of the entry above.
[32x32@2/actions]
Size=32
Scale=2
Type=Fixed

Tu directorio de temas de iconos tendría entonces un aspecto similar a este:

├── 32x32
│   └── actions
│       └── appointment-new.png
├── 32x32@2
│   └── actions
│       └── appointment-new.png
└── index.theme

Tipo de miembro Documentación

enum QIcon::Mode

Este tipo de enumeración describe el modo para el que está previsto utilizar un mapa de píxeles. Los modos definidos actualmente son:

ConstanteValorDescripción
QIcon::Normal0Muestra el mapa de píxeles cuando el usuario no está interactuando con el icono, pero la funcionalidad representada por el icono está disponible.
QIcon::Disabled1Muestra el mapa de píxeles cuando la funcionalidad representada por el icono no está disponible.
QIcon::Active2Muestra el mapa de píxeles cuando la funcionalidad representada por el icono está disponible y el usuario está interactuando con el icono, por ejemplo, pasando el ratón por encima o haciendo clic en él.
QIcon::Selected3Muestra el mapa de píxeles cuando el elemento representado por el icono está seleccionado.

enum QIcon::State

Esta enumeración describe el estado para el que está previsto utilizar un mapa de píxeles. El estado puede ser:

ConstanteValorDescripción
QIcon::On0Muestra el mapa de píxeles cuando el widget está en estado «activado»
QIcon::Off1Muestra el mapa de píxeles cuando el widget está en estado «desactivado»

[since 6.7] enum class QIcon::ThemeIcon

Esta enumeración permite acceder a los iconos que ofrecen la mayoría de las implementaciones de temas de iconos.

ConstanteValorDescripción
QIcon::ThemeIcon::AddressBookNew0El icono correspondiente a la acción de crear una nueva agenda de contactos.
QIcon::ThemeIcon::ApplicationExit1El icono para salir de una aplicación.
QIcon::ThemeIcon::AppointmentNew2El icono de la acción para crear una nueva cita.
QIcon::ThemeIcon::CallStart3El icono para iniciar o aceptar una llamada.
QIcon::ThemeIcon::CallStop4El icono para finalizar una llamada en curso.
QIcon::ThemeIcon::ContactNew5El icono de la acción para crear un nuevo contacto.
QIcon::ThemeIcon::DocumentNew6El icono para crear un nuevo documento.
QIcon::ThemeIcon::DocumentOpen7El icono de la acción para abrir un documento.
QIcon::ThemeIcon::DocumentOpenRecent8El icono para abrir un documento que se ha abierto recientemente.
QIcon::ThemeIcon::DocumentPageSetup9El icono de la acción de configuración de página.
QIcon::ThemeIcon::DocumentPrint10El icono de la acción de impresión.
QIcon::ThemeIcon::DocumentPrintPreview11El icono de la acción de vista previa de impresión.
QIcon::ThemeIcon::DocumentProperties12El icono de la acción para ver las propiedades de un documento.
QIcon::ThemeIcon::DocumentRevert13El icono de la acción para volver a una versión anterior de un documento.
QIcon::ThemeIcon::DocumentSave14El icono de la acción «Guardar ».
QIcon::ThemeIcon::DocumentSaveAs15El icono de la acción «Guardar como ».
QIcon::ThemeIcon::DocumentSend16El icono de la acción «Enviar ».
QIcon::ThemeIcon::EditClear17El icono de la acción «Borrar ».
QIcon::ThemeIcon::EditCopy18El icono de la acción «Copiar ».
QIcon::ThemeIcon::EditCut19El icono de la acción «Cortar ».
QIcon::ThemeIcon::EditDelete20El icono de la acción «Eliminar ».
QIcon::ThemeIcon::EditFind21El icono de la acción «Buscar ».
QIcon::ThemeIcon::EditPaste22El icono de la acción «Pegar ».
QIcon::ThemeIcon::EditRedo23El icono de la acción «Rehacer ».
QIcon::ThemeIcon::EditSelectAll24El icono de la acción «Seleccionar todo ».
QIcon::ThemeIcon::EditUndo25El icono de la acción «Deshacer ».
QIcon::ThemeIcon::FolderNew26El icono para crear una nueva carpeta.
QIcon::ThemeIcon::FormatIndentLess27El icono de la acción «Disminuir sangría ».
QIcon::ThemeIcon::FormatIndentMore28El icono de la acción de «Aumentar sangría ».
QIcon::ThemeIcon::FormatJustifyCenter29El icono de la acción de justificación centrada.
QIcon::ThemeIcon::FormatJustifyFill30El icono de la acción de formato «Justificación a los márgenes ».
QIcon::ThemeIcon::FormatJustifyLeft31El icono de la acción de formato «Alineación a la izquierda ».
QIcon::ThemeIcon::FormatJustifyRight32El icono de la acción de justificación a la derecha.
QIcon::ThemeIcon::FormatTextDirectionLtr33El icono de la acción de formato de texto de izquierda a derecha.
QIcon::ThemeIcon::FormatTextDirectionRtl34El icono de la acción de formato «de derecha a izquierda ».
QIcon::ThemeIcon::FormatTextBold35El icono de la acción de formato de texto en negrita.
QIcon::ThemeIcon::FormatTextItalic36El icono de la acción de formato de texto en cursiva.
QIcon::ThemeIcon::FormatTextUnderline37El icono de la acción de formato de texto subrayado.
QIcon::ThemeIcon::FormatTextStrikethrough38El icono de la acción de formato de texto tachado.
QIcon::ThemeIcon::GoDown39El icono de la acción «bajar en una lista ».
QIcon::ThemeIcon::GoHome40El icono de la acción «Ir a la página de inicio ».
QIcon::ThemeIcon::GoNext41El icono de la acción «Ir al siguiente elemento de una lista ».
QIcon::ThemeIcon::GoPrevious42El icono de la acción «Ir al elemento anterior de una lista ».
QIcon::ThemeIcon::GoUp43El icono de la acción «Subir en una lista ».
QIcon::ThemeIcon::HelpAbout44El icono del elemento «Acerca de » del menú «Ayuda».
QIcon::ThemeIcon::HelpFaq45El icono de la opción «Preguntas frecuentes » del menú «Ayuda».
QIcon::ThemeIcon::InsertImage46El icono de la acción «Insertar imagen » de una aplicación.
QIcon::ThemeIcon::InsertLink47El icono de la acción «Insertar enlace » de una aplicación.
QIcon::ThemeIcon::InsertText48El icono de la acción «Insertar texto » de una aplicación.
QIcon::ThemeIcon::ListAdd49El icono de la acción «Añadir a la lista ».
QIcon::ThemeIcon::ListRemove50El icono de la acción «Eliminar de la lista ».
QIcon::ThemeIcon::MailForward51El icono de la acción «Reenviar ».
QIcon::ThemeIcon::MailMarkImportant52El icono de la acción «marcar como importante ».
QIcon::ThemeIcon::MailMarkRead53El icono de la acción «marcar como leído ».
QIcon::ThemeIcon::MailMarkUnread54El icono de la acción «marcar como no leído ».
QIcon::ThemeIcon::MailMessageNew55El icono de la acción «Redactar nuevo correo ».
QIcon::ThemeIcon::MailReplyAll56El icono de la acción «Responder a todos ».
QIcon::ThemeIcon::MailReplySender57El icono de la acción «Responder al remitente ».
QIcon::ThemeIcon::MailSend58El icono de la acción «Enviar ».
QIcon::ThemeIcon::MediaEject59El icono de la acción «expulsar» de un reproductor multimedia o un gestor de archivos.
QIcon::ThemeIcon::MediaPlaybackPause60El icono de la acción «Pausar » de un reproductor multimedia.
QIcon::ThemeIcon::MediaPlaybackStart61El icono de la acción «Iniciar reproducción » de un reproductor multimedia.
QIcon::ThemeIcon::MediaPlaybackStop62El icono de la acción «detener» de un reproductor multimedia.
QIcon::ThemeIcon::MediaRecord63El icono de la acción de grabar de una aplicación multimedia.
QIcon::ThemeIcon::MediaSeekBackward64El icono de la acción de avance rápido hacia atrás de un reproductor multimedia.
QIcon::ThemeIcon::MediaSeekForward65El icono de avance rápido en un reproductor multimedia.
QIcon::ThemeIcon::MediaSkipBackward66El icono de la acción de salto hacia atrás de un reproductor multimedia.
QIcon::ThemeIcon::MediaSkipForward67El icono de la acción de avance rápido de un reproductor multimedia.
QIcon::ThemeIcon::ObjectRotateLeft68El icono de la acción de girar hacia la izquierda aplicada a un objeto.
QIcon::ThemeIcon::ObjectRotateRight69El icono de la acción de girar a la derecha que se realiza sobre un objeto.
QIcon::ThemeIcon::ProcessStop70El icono de la acción de detener en aplicaciones con acciones que pueden tardar un tiempo en procesarse, como la carga de una página web en un navegador.
QIcon::ThemeIcon::SystemLockScreen71El icono de la acción de bloquear la pantalla.
QIcon::ThemeIcon::SystemLogOut72El icono de la acción de cerrar sesión.
QIcon::ThemeIcon::SystemSearch73El icono de la acción de búsqueda.
QIcon::ThemeIcon::SystemReboot74El icono de la acción de reinicio.
QIcon::ThemeIcon::SystemShutdown75El icono de la acción de apagar el equipo.
QIcon::ThemeIcon::ToolsCheckSpelling76El icono de la acción «Revisar ortografía ».
QIcon::ThemeIcon::ViewFullscreen77El icono de la acción «Pantalla completa ».
QIcon::ThemeIcon::ViewRefresh78El icono de la acción de actualizar.
QIcon::ThemeIcon::ViewRestore79El icono para salir de la vista a pantalla completa.
QIcon::ThemeIcon::WindowClose80El icono de la acción «cerrar ventana ».
QIcon::ThemeIcon::WindowNew81El icono de la acción «Nueva ventana ».
QIcon::ThemeIcon::ZoomFitBest82El icono para ajustar a la pantalla.
QIcon::ThemeIcon::ZoomIn83El icono de la acción de acercar.
QIcon::ThemeIcon::ZoomOut84El icono para alejar la imagen.
QIcon::ThemeIcon::AudioCard85El icono del dispositivo de reproducción de audio.
QIcon::ThemeIcon::AudioInputMicrophone86El icono del dispositivo de entrada de audio del micrófono.
QIcon::ThemeIcon::Battery87El icono del dispositivo de batería del sistema.
QIcon::ThemeIcon::CameraPhoto88El icono de una cámara digital.
QIcon::ThemeIcon::CameraVideo89El icono del dispositivo de cámara de vídeo.
QIcon::ThemeIcon::CameraWeb90El icono del dispositivo de cámara web.
QIcon::ThemeIcon::Computer91El icono que representa el dispositivo informático en su conjunto.
QIcon::ThemeIcon::DriveHarddisk92El icono de las unidades de disco duro.
QIcon::ThemeIcon::DriveOptical93El icono de las unidades de soportes ópticos, como CD y DVD.
QIcon::ThemeIcon::InputGaming94El icono del dispositivo de entrada para videojuegos.
QIcon::ThemeIcon::InputKeyboard95El icono del dispositivo de entrada «teclado».
QIcon::ThemeIcon::InputMouse96El icono del ratón.
QIcon::ThemeIcon::InputTablet97El icono de las tabletas gráficas.
QIcon::ThemeIcon::MediaFlash98El icono de los soportes flash, como una tarjeta de memoria.
QIcon::ThemeIcon::MediaOptical99El icono de los soportes ópticos físicos, como los CD y los DVD.
QIcon::ThemeIcon::MediaTape100El icono de los soportes físicos genéricos de cinta.
QIcon::ThemeIcon::MultimediaPlayer101El icono de los dispositivos genéricos de reproducción multimedia.
QIcon::ThemeIcon::NetworkWired102El icono de las conexiones de red por cable.
QIcon::ThemeIcon::NetworkWireless103El icono de las conexiones de red inalámbricas.
QIcon::ThemeIcon::Phone104El icono de los dispositivos telefónicos.
QIcon::ThemeIcon::Printer105El icono de una impresora.
QIcon::ThemeIcon::Scanner106El icono de un escáner.
QIcon::ThemeIcon::VideoDisplay107El icono del monitor en el que se muestra el vídeo.
QIcon::ThemeIcon::AppointmentMissed108El icono que indica que se ha perdido una cita.
QIcon::ThemeIcon::AppointmentSoon109El icono que indica que una cita tendrá lugar próximamente.
QIcon::ThemeIcon::AudioVolumeHigh110El icono que se utiliza para indicar un volumen de audio alto.
QIcon::ThemeIcon::AudioVolumeLow111El icono que se utiliza para indicar un volumen de audio bajo.
QIcon::ThemeIcon::AudioVolumeMedium112El icono que indica un volumen de audio medio.
QIcon::ThemeIcon::AudioVolumeMuted113El icono que indica que el sonido está silenciado durante la reproducción de audio.
QIcon::ThemeIcon::BatteryCaution114El icono que aparece cuando la batería está por debajo del 40 %.
QIcon::ThemeIcon::BatteryLow115El icono que se utiliza cuando la batería está por debajo del 20 %.
QIcon::ThemeIcon::DialogError116El icono que se utiliza cuando se abre un cuadro de diálogo para explicar al usuario una situación de error.
QIcon::ThemeIcon::DialogInformation117El icono que se utiliza cuando se abre un cuadro de diálogo para proporcionar al usuario información que puede ser relevante para la acción solicitada.
QIcon::ThemeIcon::DialogPassword118El icono que se utiliza cuando se abre un cuadro de diálogo en el que se solicitan las credenciales de autenticación de un usuario.
QIcon::ThemeIcon::DialogQuestion119El icono que se utiliza cuando se abre un cuadro de diálogo para plantear una pregunta sencilla al usuario.
QIcon::ThemeIcon::DialogWarning120El icono que se utiliza cuando se abre un cuadro de diálogo para advertir al usuario de posibles problemas con la acción solicitada.
QIcon::ThemeIcon::FolderDragAccept121El icono que se utiliza para una carpeta mientras se arrastra un objeto válido hacia ella.
QIcon::ThemeIcon::FolderOpen122El icono que se utiliza para las carpetas cuando su contenido se muestra en la misma ventana.
QIcon::ThemeIcon::FolderVisiting123El icono que se utiliza para las carpetas mientras se muestra su contenido en otra ventana.
QIcon::ThemeIcon::ImageLoading124El icono que se utiliza mientras se carga otra imagen.
QIcon::ThemeIcon::ImageMissing125El icono que se utiliza cuando no se ha podido cargar otra imagen.
QIcon::ThemeIcon::MailAttachment126El icono de un mensaje que contiene archivos adjuntos.
QIcon::ThemeIcon::MailUnread127El icono de un mensaje no leído.
QIcon::ThemeIcon::MailRead128El icono de un mensaje leído.
QIcon::ThemeIcon::MailReplied129El icono de un mensaje al que se ha respondido.
QIcon::ThemeIcon::MediaPlaylistRepeat130El icono del modo de repetición de un reproductor multimedia.
QIcon::ThemeIcon::MediaPlaylistShuffle131El icono del modo aleatorio de un reproductor multimedia.
QIcon::ThemeIcon::NetworkOffline132El icono que indica que el dispositivo no está conectado a la red.
QIcon::ThemeIcon::PrinterPrinting133El icono que aparece mientras un trabajo de impresión se está enviando correctamente a un dispositivo de impresión.
QIcon::ThemeIcon::SecurityHigh134El icono que se utiliza para indicar que se sabe que el nivel de seguridad de un elemento es alto.
QIcon::ThemeIcon::SecurityLow135El icono que indica que se sabe que el nivel de seguridad de un elemento es bajo.
QIcon::ThemeIcon::SoftwareUpdateAvailable136El icono que se utiliza para indicar que hay una actualización disponible.
QIcon::ThemeIcon::SoftwareUpdateUrgent137El icono que indica que hay una actualización urgente disponible.
QIcon::ThemeIcon::SyncError138El icono que se muestra cuando se produce un error al intentar sincronizar datos entre dispositivos.
QIcon::ThemeIcon::SyncSynchronizing139El icono que aparece mientras los datos se sincronizan correctamente entre dispositivos.
QIcon::ThemeIcon::UserAvailable140El icono que se utiliza para indicar que un usuario está disponible.
QIcon::ThemeIcon::UserOffline141El icono que se utiliza para indicar que un usuario no está disponible.
QIcon::ThemeIcon::WeatherClear142El icono que se utiliza para indicar que el cielo está despejado.
QIcon::ThemeIcon::WeatherClearNight143El icono que se utiliza para indicar que el cielo está despejado por la noche.
QIcon::ThemeIcon::WeatherFewClouds144El icono que se utiliza para indicar que el cielo está parcialmente nublado.
QIcon::ThemeIcon::WeatherFewCloudsNight145El icono que se utiliza para indicar que el cielo está parcialmente nublado durante la noche.
QIcon::ThemeIcon::WeatherFog146El icono que se utiliza para indicar que hay niebla.
QIcon::ThemeIcon::WeatherShowers147El icono que se utiliza para indicar que hay chubascos.
QIcon::ThemeIcon::WeatherSnow148El icono que se utiliza para indicar que está nevando.
QIcon::ThemeIcon::WeatherStorm149El icono que se utiliza para indicar que hay tormenta.

Esta enumeración se introdujo en Qt 6.7.

Véase también Creating an icon from a theme or icon library y fromTheme().

Documentación de las funciones miembro

[noexcept] QIcon::QIcon()

Crea un icono nulo.

[explicit] QIcon::QIcon(QIconEngine *engine)

Crea un icono con un icono específico engine. El icono asume el control del motor.

QIcon::QIcon(const QPixmap &pixmap)

Crea un icono a partir de un objeto ` pixmap`.

[explicit] QIcon::QIcon(const QString &fileName)

Crea un icono a partir del archivo con el fileName especificado. El archivo se cargará cuando sea necesario.

Si fileName contiene una ruta relativa (por ejemplo, solo el nombre del archivo), el archivo en cuestión debe encontrarse en relación con el directorio de trabajo en tiempo de ejecución.

El nombre del archivo puede hacer referencia a un archivo real en el disco o a uno de los recursos incrustados en la aplicación. Consulte la descripción general del sistema de recursos para obtener más detalles sobre cómo incrustar imágenes y otros archivos de recursos en el ejecutable de la aplicación.

Utiliza las funciones ` QImageReader::supportedImageFormats()` y ` QImageWriter::supportedImageFormats()` para obtener una lista completa de los formatos de archivo compatibles.

QIcon::QIcon(const QIcon &other)

Crea una copia de other. Es muy rápido.

[noexcept] QIcon::QIcon(QIcon &&other)

Move crea una instancia de QIcon, haciendo que apunte al mismo objeto al que apuntaba other.

[noexcept] QIcon::~QIcon()

Elimina el icono.

QSize QIcon::actualSize(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve el tamaño real del icono para los valores solicitados size, mode y state. El resultado puede ser menor que el solicitado, pero nunca mayor. El tamaño devuelto se expresa en píxeles independientes del dispositivo (esto es relevante para mapas de píxeles de alta resolución).

Véanse también pixmap() y paint().

void QIcon::addFile(const QString &fileName, const QSize &size = QSize(), QIcon::Mode mode = Normal, QIcon::State state = Off)

Añade una imagen del archivo con la ruta fileName indicada al icono, como una especialización de size, mode y state. El archivo se cargará cuando sea necesario. Nota: los motores de iconos personalizados pueden ignorar los mapas de píxeles añadidos adicionalmente.

Si fileName contiene una ruta relativa (por ejemplo, solo el nombre del archivo), el archivo correspondiente debe encontrarse en relación con el directorio de trabajo en tiempo de ejecución.

El nombre del archivo puede hacer referencia a un archivo real en el disco o a uno de los recursos integrados de la aplicación. Consulta la descripción general del sistema de recursos para obtener más detalles sobre cómo integrar imágenes y otros archivos de recursos en el ejecutable de la aplicación.

Utilice las funciones QImageReader::supportedImageFormats() y QImageWriter::supportedImageFormats() para obtener una lista completa de los formatos de archivo compatibles.

Si existe una versión de alta resolución de la imagen (identificada por el sufijo @2x en el nombre base), se carga automáticamente y se añade con la relación de píxeles del dispositivo establecida en el valor 2. Esto se puede desactivar configurando la variable de entorno QT_HIGHDPI_DISABLE_2X_IMAGE_LOADING (véase QImageReader).

Nota: Cuando se añade un nombre de archivo no vacío a un QIcon, el icono deja de ser nulo, incluso si el archivo no existe o apunta a un archivo dañado.

Véanse también addPixmap() y QPixmap::devicePixelRatio().

void QIcon::addPixmap(const QPixmap &pixmap, QIcon::Mode mode = Normal, QIcon::State state = Off)

Añade « pixmap » al icono, como especialización de « mode » y « state ».

Los motores de iconos personalizados pueden ignorar libremente los mapas de píxeles añadidos adicionalmente.

Véase también addFile().

QList<QSize> QIcon::availableSizes(QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve una lista de los tamaños de icono disponibles para los valores especificados en « mode » y « state ».

qint64 QIcon::cacheKey() const

Devuelve un número que identifica el contenido de este objeto ` QIcon `. Diferentes objetos ` QIcon ` pueden tener la misma clave si hacen referencia al mismo contenido.

La clave cacheKey() cambiará cuando se modifique el icono mediante addPixmap() o addFile().

Las claves de caché resultan especialmente útiles en combinación con el almacenamiento en caché.

Véase también QPixmap::cacheKey().

[static] QStringList QIcon::fallbackSearchPaths()

Devuelve las rutas de búsqueda alternativas para los iconos.

Las rutas de búsqueda alternativas se consultan para archivos de iconos independientes si current icon theme o fallback icon theme no proporcionan resultados para la búsqueda de un icono.

Si no se especifican, las rutas de búsqueda alternativas las definirá la plataforma.

Véase también setFallbackSearchPaths() y themeSearchPaths().

[static] QString QIcon::fallbackThemeName()

Devuelve el nombre del tema de iconos de reserva.

Si no se establece, la plataforma definirá el tema de iconos de reserva.

Nota: Por el momento, los temas de iconos de reservade la plataforma solo están implementados en sistemas basados en Freedesktop, y el tema de iconos depende de la configuración de tu escritorio.

Véase también setFallbackThemeName() y themeName().

[static] QIcon QIcon::fromTheme(const QString &name)

Devuelve el QIcon correspondiente a name en el current icon theme.

Si el tema actual no proporciona un icono para name, se consulta fallback icon theme, antes de recurrir a la búsqueda de archivos de iconos independientes en fallback icon search path. Por último, se consulta la biblioteca de iconos nativa de la plataforma.

Para obtener un icono del tema de iconos actual:

QIcon undoicon = QIcon::fromTheme(QIcon::ThemeIcon::EditUndo);

Si no se ha establecido explícitamente un icon theme mediante setThemeName(), se utilizará un tema de iconos definido por la plataforma.

Véase también themeName(), fallbackThemeName(), setThemeName(), themeSearchPaths(), fallbackSearchPaths() y la especificación de nomenclatura de iconos de Freedesktop.

[static, since 6.7] QIcon QIcon::fromTheme(QIcon::ThemeIcon icon)

[static, since 6.7] QIcon QIcon::fromTheme(QIcon::ThemeIcon icon, const QIcon &fallback)

Devuelve el QIcon correspondiente a icon en el current icon theme.

Si el tema actual no proporciona un icono para icon, se consulta fallback icon theme antes de recurrir a la búsqueda de archivos de iconos independientes en fallback icon search path. Por último, se consulta la biblioteca de iconos nativa de la plataforma.

Si no se encuentra ningún icono y se ha proporcionado un ` fallback `, se devuelve ` fallback `. Esto resulta útil para proporcionar una alternativa garantizada, independientemente de si el conjunto actual de temas de iconos y las rutas de alternativa admiten el icono solicitado.

Si no se encuentra ningún icono y no se proporciona ningún ` fallback `, se devuelve un ` QIcon ` vacío, construido por defecto.

Estas funciones se introdujeron en Qt 6.7.

[static] QIcon QIcon::fromTheme(const QString &name, const QIcon &fallback)

Devuelve el QIcon correspondiente a name en el current icon theme.

Si el tema actual no proporciona un icono para name, se consulta el fallback icon theme antes de recurrir a la búsqueda de archivos de iconos independientes en el fallback icon search path. Por último, se consulta la biblioteca de iconos nativa de la plataforma.

Si no se encuentra ningún icono, se devuelve fallback.

Esto resulta útil para proporcionar una alternativa garantizada, independientemente de si el conjunto actual de temas de iconos y rutas alternativas admite el icono solicitado.

Por ejemplo:

QIcon undoicon = QIcon::fromTheme(QIcon::ThemeIcon::EditUndo, QIcon(":/undo.png"));

Esta es una función sobrecargada.

Véase también fallbackThemeName() y fallbackSearchPaths().

[static] bool QIcon::hasThemeIcon(const QString &name)

Devuelve « true » si hay un icono disponible para « name » en el tema de iconos actual o en cualquiera de los temas alternativos, tal y como se describe en fromTheme(); en caso contrario, devuelve « false ».

Véanse también themeSearchPaths(), fromTheme() y setThemeName().

[static, since 6.7] bool QIcon::hasThemeIcon(QIcon::ThemeIcon icon)

Devuelve ` true ` si hay un icono disponible para ` icon ` en el tema de iconos actual o en cualquiera de los temas de reserva, tal y como se describe en ` fromTheme()`, y, en caso contrario, devuelve ` false`.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.7.

Véase también fromTheme().

bool QIcon::isMask() const

Devuelve « true » si este icono se ha marcado como imagen de máscara. Algunas plataformas representan los iconos de máscara de forma diferente (por ejemplo, los iconos de menú en macOS).

Véase también setIsMask().

bool QIcon::isNull() const

Devuelve ` true ` si el icono está vacío; en caso contrario, devuelve ` false`.

Un icono está vacío si no tiene ni mapa de píxeles ni nombre de archivo.

Nota: Es posible que incluso un icono que no sea nulo no pueda crear mapas de píxeles válidos, por ejemplo, si el archivo no existe o no se puede leer.

QString QIcon::name() const

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

Dependiendo de cómo se haya creado el icono, puede tener un nombre asociado. Este es el caso de los iconos creados con fromTheme().

Véanse también fromTheme() y QIconEngine::iconName().

void QIcon::paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Utiliza la función ` painter ` para dibujar el icono con los valores especificados ` alignment`, los valores obligatorios ` mode` y ` state ` dentro del rectángulo ` rect`.

Véanse también actualSize() y pixmap().

void QIcon::paint(QPainter *painter, int x, int y, int w, int h, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Dibuja el icono dentro del rectángulo QRect(x, y, w, h).

Se trata de una función sobrecargada.

QPixmap QIcon::pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve un mapa de píxeles con los valores solicitados de ` size`, ` mode` y ` state`, generándolo si es necesario. El mapa de píxeles puede ser más pequeño que el solicitado, pero nunca más grande, a menos que la relación de píxeles del dispositivo del mapa de píxeles devuelto sea superior a 1.

Véanse también actualSize() y paint().

QPixmap QIcon::pixmap(int extent, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve un mapa de píxeles de tamaño QSize(extent, extent). El mapa de píxeles puede ser más pequeño que el solicitado, pero nunca más grande, a menos que la relación de píxeles del dispositivo del mapa de píxeles devuelto sea mayor que 1.

Esta es una función sobrecargada.

[since 6.0] QPixmap QIcon::pixmap(const QSize &size, qreal devicePixelRatio, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve un mapa de píxeles con los valores solicitados de « size », « devicePixelRatio », « mode » y « state », generando uno con los valores « mode » y « state » especificados si es necesario. El mapa de píxeles puede ser más pequeño que el solicitado, pero nunca más grande, a menos que la relación de píxeles del dispositivo del mapa de píxeles devuelto sea mayor que 1.

Nota: Es posible quela relación de píxeles del dispositivo solicitada no coincida con la devuelta. Esto retrasa el escalado del mapa de píxeles ( QPixmap ) hasta que se dibuje posteriormente.

Nota: Antes de Qt 6.8, esta función pasaba erróneamente el tamaño del mapa de píxeles dependiente del dispositivo a ` QIconEngine::scaledPixmap()`; desde Qt 6.8, se pasa el tamaño independiente del dispositivo (sin escalar con ` devicePixelRatio`).

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

Véanse también ` actualSize()` y ` paint()`.

QPixmap QIcon::pixmap(int w, int h, QIcon::Mode mode = Normal, QIcon::State state = Off) const

Devuelve un mapa de píxeles de tamaño QSize(w, h). El mapa de píxeles puede ser más pequeño que el solicitado, pero nunca más grande, a menos que la relación de píxeles del dispositivo del mapa de píxeles devuelto sea mayor que 1.

Esta es una función sobrecargada.

[static] void QIcon::setFallbackSearchPaths(const QStringList &paths)

Establece las rutas de búsqueda alternativas para los iconos en paths.

Las rutas de búsqueda alternativas se consultan en busca de archivos de iconos independientes si current icon theme o fallback icon theme no ofrecen resultados para la búsqueda de un icono.

Por ejemplo:

QIcon::setFallbackSearchPaths(QIcon::fallbackSearchPaths() << "my/search/path");

Véase también fallbackSearchPaths() y setThemeSearchPaths().

[static] void QIcon::setFallbackThemeName(const QString &name)

Establece el tema de iconos de reserva en name.

El tema de iconos de reserva se consulta para los iconos que no proporciona current icon theme, o si current icon theme no existe.

El name debe corresponder a un tema con el mismo formato que el documentado en setThemeName(), y se buscará en themeSearchPaths().

Nota: Los temas de iconosde reserva deben configurarse antes de crear QGuiApplication, para garantizar una inicialización correcta.

Véase también fallbackThemeName(), themeSearchPaths() y themeName().

void QIcon::setIsMask(bool isMask)

Indica que este icono es una imagen de máscara (booleano isMask) y, por lo tanto, puede modificarse en función del lugar en el que se muestre.

Véase también isMask().

[static] void QIcon::setThemeName(const QString &name)

Establece el tema de iconos actual en « name ».

Si el tema coincide con el nombre de una fuente instalada que proporcione glifos con nombre, los archivos « QIcon::fromTheme » que coincidan con uno de los glifos generarán un icono para dicho glifo.

De lo contrario, el tema se buscará en themeSearchPaths(). Por el momento, el único formato de tema de iconos compatible es la Especificación de temas de iconos de Freedesktop. El name debe corresponder a un nombre de directorio en themeSearchPath() que contenga un archivo index.theme que describa su contenido.

Véase también themeSearchPaths(), themeName() y la Especificación de temas de iconos de Freedesktop.

[static] void QIcon::setThemeSearchPaths(const QStringList &paths)

Establece las rutas de búsqueda de los temas de iconos en paths.

El contenido de paths debe seguir el formato de temas documentado en setThemeName().

Véase también themeSearchPaths(), fromTheme() y setThemeName().

[noexcept] void QIcon::swap(QIcon &other)

Cambia este icono por other. Esta operación es muy rápida y nunca falla.

[static] QString QIcon::themeName()

Devuelve el nombre del tema de iconos actual.

Si no se especifica, la plataforma definirá el tema de iconos actual.

Nota: Por el momento, los temas de iconosde la plataforma solo están implementados en sistemas basados en Freedesktop, y el tema de iconos depende de la configuración de tu escritorio.

Véase también setThemeName(), themeSearchPaths(), fromTheme() y hasThemeIcon().

[static] QStringList QIcon::themeSearchPaths()

Devuelve las rutas de búsqueda de los temas de iconos.

Las rutas de búsqueda predeterminadas las definirá la plataforma. Todas las plataformas contarán además con el directorio de recursos :\icons como opción alternativa.

Véase también setThemeSearchPaths(), fromTheme() y setThemeName().

QIcon::operator QVariant() const

Devuelve el icono como un objeto ` QVariant`.

[noexcept] QIcon &QIcon::operator=(QIcon &&other)

Asigna « other » a esta instancia de « QIcon ». .

QIcon &QIcon::operator=(const QIcon &other)

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

Elementos no miembros relacionados

QDataStream &operator<<(QDataStream &stream, const QIcon &icon)

Escribe el archivo « icon » especificado en el archivo « stream » especificado como una imagen PNG. Si el icono contiene más de una imagen, todas las imágenes se escribirán en el flujo. Ten en cuenta que escribir el flujo en un archivo no generará un archivo de imagen válido.

QDataStream &operator>>(QDataStream &stream, QIcon &icon)

Lee una imagen, o un conjunto de imágenes, desde la ruta stream y las guarda en la ruta icon.

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