Iconos en los controles de « Qt Quick »
En los controles de Qt Quick, los botones, los delegados de elementos y los elementos de menú pueden mostrar un icono además de una etiqueta de texto.
Uso de iconos
AbstractButton y Action proporcionan las siguientes propiedades mediante las cuales se pueden configurar los iconos:
icon.nameicon.sourceicon.widthicon.heighticon.coloricon.cache
Los iconos de tema se especifican mediante un nombre, y los iconos normales mediante una URL de origen. Se pueden configurar tanto « icon.name » como « icon.source » para garantizar que siempre se encuentre un icono. Si el icono se encuentra en el tema, siempre se utilizará, incluso si también se ha configurado « icon.source ». Si el icono no se encuentra en el tema, se utilizará en su lugar « icon.source ».
Button {
icon.name: "edit-cut"
icon.source: "images/cut.png"
}Cada Qt Quick controla dos solicitudes de estilo: un tamaño y un color predeterminados para el icono según sus directrices, pero es posible anular estos valores configurando las propiedades icon.width, icon.height y icon.color.
La imagen que se carga como icono cuando no se han establecido las propiedades width y height depende del tipo de icono que se utilice. En el caso de los iconos de tema, se elegirá el tamaño disponible más cercano. Para los iconos normales, el comportamiento es el mismo que el de la propiedad sourceSize de Image.
El color del icono se especifica por defecto de forma que coincida con el color del texto en los distintos estados. Para utilizar un icono con los colores originales, establece el color en "transparent".
Button {
icon.color: "transparent"
icon.source: "images/logo.png"
}En el caso de los botones, la propiedad display se puede utilizar para controlar cómo se muestran el icono y el texto dentro del botón.
La propiedad ` icon.cache ` controla si la imagen del icono se almacena en caché o no. Para obtener más información, consulta cache.
Temas de iconos
Los temas de iconos compatibles deben seguir la especificación de temas de iconos de freedesktop, que se puede consultar aquí: http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html.
Tradicionalmente, solo Linux y UNIX admiten temas de iconos a nivel de plataforma, pero es posible incluir un tema de iconos compatible en una aplicación para utilizar iconos temáticos en cualquier plataforma.
La ruta de búsqueda predeterminada icon theme search paths depende de la plataforma. En Linux y UNIX, la ruta de búsqueda utilizará la variable de entorno XDG_DATA_DIRS si está disponible. Todas las plataformas tienen el directorio de recursos :/icons como opción alternativa. Las rutas de búsqueda personalizadas para temas de iconos se pueden configurar con QIcon::setThemeSearchPaths().
El siguiente ejemplo integra un tema de iconos llamado «mytheme» en los recursos de la aplicación utilizando el sistema de recursos de Qt.
<RCC>
<qresource prefix="/">
<file>icons/mytheme/index.theme</file>
<file>icons/mytheme/32x32/myicon.png</file>
<file>icons/mytheme/32x32@2/myicon.png</file>
</qresource>
</RCC>El archivo index.theme describe los atributos generales del tema de iconos y enumera los directorios de iconos disponibles del tema:
[Icon Theme]
Name=mytheme
Comment=My Icon Theme
Directories=32x32,32x32@2
[32x32]
Size=32
Type=Fixed
[32x32@2]
Size=32
Scale=2
Type=FixedPara utilizar el tema de iconos integrado, una aplicación debe llamar a QIcon::setThemeName() antes de cargar el archivo QML principal:
#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QIcon>
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
QIcon::setThemeName("mytheme"); // <--
QQmlApplicationEngine engine;
engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
return app.exec();
}Ahora es posible utilizar iconos con nombre del tema de iconos integrado sin tener que especificar ninguna fuente alternativa:
Button {
icon.name: "myicon"
}El ejemplo «Gallery» y la «Wearable Demo» proporcionan aplicaciones completas y ejecutables con un tema de iconos incluido.
© 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.