Hojas de estilo de Qt
Las hojas de estilo de Qt permiten personalizar el aspecto de los widgets mediante reglas de texto, además de las posibilidades que ofrece la subclasificación de ` QStyle`. Los conceptos, la terminología y la sintaxis de las hojas de estilo de Qt se inspiran en gran medida en las hojas de estilo en cascada (CSS) de HTML, pero adaptadas al mundo de los widgets.
Las hojas de estilo son una herramienta para la creación de prototipos y para pequeños ajustes locales; para el aspecto definitivo de una aplicación, implementa una clase ` QStyle ` o utiliza StyleKit. El artículo «Enfoques de estilo para Qt Widgets » explica las desventajas de las hojas de estilo y compara los distintos enfoques.
Temas:
- Descripción general
- La sintaxis de las hojas de estilo
- Qt Widgets Designer Integración
- Personalización de « Qt Widgets » mediante hojas de estilo
- Referencia de hojas de estilo de Qt
- Ejemplos de hojas de estilo de Qt
Nota: Si se utilizan hojas de estilo de Qt en el mismo widget junto con funciones que definen la apariencia de los widgets, como ` QWidget::setFont()` o ` QTreeWidgetItem::setBackground()`, las hojas de estilo tendrán prioridad en caso de conflicto entre las configuraciones.
Descripción general
Las hojas de estilo son especificaciones textuales que pueden aplicarse a toda la aplicación mediante ` QApplication::setStyleSheet()` o a un widget específico (y sus hijos) mediante ` QWidget::setStyleSheet()`. Si se definen varias hojas de estilo en distintos niveles, Qt deduce la hoja de estilo efectiva a partir de todas las que están definidas. A esto se le denomina «cascada».
Establece la hoja de estilos de la aplicación una sola vez, antes de que se muestre la primera ventana. Cambiar la hoja de estilos en tiempo de ejecución puede dar lugar a resultados incoherentes, en los que la nueva hoja de estilos solo anula algunas partes de la hoja de estilos anterior. No utilices esta función para cambiar de tema en tiempo de ejecución.
Por ejemplo, la siguiente hoja de estilos especifica que todos los elementos ` QLineEdit` deben utilizar el amarillo como color de fondo, y que todos los elementos ` QCheckBox` deben utilizar el rojo como color de texto:
Para este tipo de personalización, las hojas de estilo son mucho más potentes que QPalette. Por ejemplo, podría resultar tentador establecer el rol QPalette::Button en rojo para un QPushButton con el fin de obtener un botón rojo. Sin embargo, no se garantizaba que esto funcionara para todos los estilos, ya que los autores de estilos están limitados por las directrices de las diferentes plataformas y (en Windows y macOS) por el motor de temas nativo.
Las hojas de estilo te permiten realizar todo tipo de personalizaciones que resultan difíciles o imposibles de llevar a cabo utilizando únicamente QPalette. Si quieres fondos amarillos para los campos obligatorios, texto en rojo para botones que pueden provocar errores graves o casillas de selección con un diseño especial, las hojas de estilo son la solución.
Las hojas de estilo se aplican sobre el « widget style » actual, lo que significa que tus aplicaciones tendrán un aspecto lo más nativo posible, pero se tendrán en cuenta las restricciones de las hojas de estilo. A diferencia de los ajustes de paleta, las hojas de estilo ofrecen garantías: si estableces el color de fondo de un QPushButton en rojo, puedes estar seguro de que el botón tendrá un fondo rojo en todos los estilos y en todas las plataformas. Además, Qt Widgets Designer ofrece integración con hojas de estilo, lo que facilita la visualización de los efectos de una hoja de estilo en diferentes widget styles.
Las hojas de estilo también pueden dar a un prototipo un aspecto distintivo sin necesidad de crear subclases de ` QStyle`, por ejemplo, especificando imágenes para los botones de opción y las casillas de selección.
Cuando una hoja de estilo está activa, el QStyle devuelto por QWidget::style() es un estilo «hoja de estilo» envolvente, no el estilo específico de la plataforma. El estilo contenedor garantiza que se respete cualquier hoja de estilo activa y, en caso contrario, reenvía las operaciones de dibujo al estilo subyacente específico de la plataforma (por ejemplo, el estilo « windows11 » en Windows o el estilo « macos » en macOS; véase QStyleFactory).
Consideraciones de seguridad
El texto de la hoja de estilos es analizado por Qt y puede hacer referencia a recursos externos: la función url() puede apuntar a cualquier archivo local o recurso de Qt, que Qt cargará y representará a continuación, por ejemplo, como una imagen de fondo, borde o icono. Las aplicaciones que construyan una hoja de estilos, en su totalidad o en parte, a partir de datos que no estén totalmente bajo su propio control —como un archivo de tema seleccionable en tiempo de ejecución, una ruta proporcionada mediante la opción de línea de comandos -stylesheet o contenido procedente de un complemento— deben tratar ese contenido como lo harían con cualquier otra ruta de archivo procedente de una fuente no fiable. Una hoja de estilo maliciosa puede hacer que Qt lea y muestre el contenido de archivos locales arbitrarios a los que el proceso de la aplicación tenga permiso de acceso.
Las hojas de estilo que están codificadas de forma fija en la aplicación, o incrustadas en un archivo de recursos de Qt compilado, no se ven afectadas por esta consideración, ya que su contenido está totalmente controlado por la propia aplicación.
© 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.