Qt Labs StyleKit
StyleKit es un sistema de estilos declarativo para los controles deQt Quick , basado en las plantillas de Qt Quick . Te permite definir un estilo visual completo para todos tus controles a partir de un único objeto Style, incluyendo compatibilidad con themes, el estilo de state-based y transitions. StyleKit se encarga automáticamente de la implementación subyacente de las plantillas, lo que te permite centrarte exclusivamente en aspectos visuales como colors, las dimensiones, borders y shadows.
Una de las principales ventajas de StyleKit es su sistema jerárquico de propiedades: basta con establecer una propiedad una sola vez en un tipo base, como abstractButton, para que se aplique automáticamente a todos los controles similares a botones. Se puede sobrescribir cuando sea necesario para controles o estados específicos. Los cambios en el estilo se reflejan al instante en todos los controles, lo que garantiza la coherencia al tiempo que permite una personalización detallada.
Para los controles que requieran un comportamiento personalizado más allá de lo que ofrece StyleKit, sigue siendo posible implementar plantillas personalizadas e integrarlas a la perfección junto con los controles con estilo de StyleKit.
Características principales
- Estilización declarativa: una API de QML fácil de usar que te permite centrarte en el diseño en lugar de en la implementación
- Valores por defecto jerárquicos: todas las propiedades se propagan. Configúralas una vez y sobrescríbelas cuando sea necesario
- Estilo basado en estados: diseña apariencias distintas para los estados de desplazamiento del cursor, pulsado, enfocado, etc.
- Transiciones animadas: define animaciones fluidas entre estados
- Compatibilidad con temas: diseña temas claros y oscuros, así como tantos temas personalizados como desees
- Variaciones: diseña múltiples variaciones de los mismos controles
- Integración de paletas y fuentes: configura las paletas y las fuentes de los controles mediante QML
El siguiente ejemplo muestra un ejemplo básico de un estilo:
// PlainStyle.qml
import QtQuick
import Qt.labs.StyleKit
Style {
control {
padding: 6
background {
radius: 4
width: 100
height: 36
}
indicator {
width: 20
height: 20
border.width: 1
}
handle {
width: 20
height: 20
radius: 10
}
}
button {
background {
width: 120
shadow.opacity: 0.6
shadow.verticalOffset: 2
shadow.horizontalOffset: 2
gradient: Gradient {
GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
}
}
pressed.background.scale: 0.95
}
slider {
indicator.fillWidth: true
indicator.height: 6
indicator.radius: 3
}
light: Theme {
applicationWindow {
background.color: "whitesmoke"
}
control {
text.color: "black"
background.color: "#e8e8e8"
background.border.color: "#c0c0c0"
hovered.background.color: "#d0d0d0"
}
button {
text.color: "white"
background.color: "cornflowerblue"
background.shadow.color: "gray"
hovered.background.color: "royalblue"
}
}
dark: Theme {
applicationWindow {
background.color: Qt.darker("gray", 2.0)
}
control {
text.color: "white"
background.color: "#3a3a3a"
background.border.color: "#555555"
hovered.background.color: "#4a4a4a"
}
button {
background.color: "sandybrown"
background.shadow.color: "black"
hovered.background.color: Qt.darker("sandybrown", 1.2)
}
}
}Así es como se configura el estilo en tu aplicación:
// Main.qml
import QtQuick
import Qt.labs.StyleKit
ApplicationWindow {
id: app
width: 1024
height: 800
visible: true
// Assign the style to be used
StyleKit.style: PlainStyle {}
// Controls are used as normal
Column {
anchors.fill: parent
anchors.margins: 10
spacing: 10
Button {
text: "Button"
}
Slider {
width: 200
}
}
}Uso del módulo en tu proyecto
Los tipos QML del módulo están disponibles a través de la importación « QtQuick.labs.StyleKit ». Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:
import Qt.labs.StyleKitArtículos y guías
- Descripción general de las características de StyleKit: una breve introducción a las funciones de estilo disponibles
- Resolución de propiedades de StyleKit: cómo resuelve StyleKit los valores de las propiedades de estilo
- Estilo de reserva de referencia
Ejemplos
- Ejemplo de controles rápidos de StyleKit: muestra cómo aplicar estilos a los controles de lQt Quick s mediante StyleKit.
- Ejemplo de widgets de StyleKit: muestra cómo aplicar estilos Qt Widgets utilizando StyleKit.
- Ejemplo de delegados personalizados de StyleKit: muestra cómo utilizar delegados personalizados y efectos de sombreado con StyleKit.
Clases de C++
Aplica un estilo de StyleKit de Qt Labs a Qt Widgets |
tipos QML
Tipo base abstracto con propiedades comunes tanto a «Style» como a «Theme» | |
Define el estilo del borde de un delegado | |
Describe el estilo de un control en un estado determinado | |
Define el estilo de un control en el estado normal | |
Define las propiedades personalizables de un control | |
Define el estilo de un control personalizado (no integrado) | |
Define un tema personalizado con nombre | |
Define el aspecto visual de un elemento dentro de un control | |
Define el estilo del controlador para controles como Switch, Slider y RangeSlider | |
Define el estilo de la imagen de un delegado | |
Define el estilo del indicador de un control | |
Define el estilo de la sombra proyectada de un delegado | |
Tipo base abstracto que contiene los tipos de control a los que se les puede aplicar un estilo | |
Tipo raíz para una definición de estilo | |
Un tipo de conveniencia para animar propiedades de estilo | |
Un singleton para establecer y acceder al estilo actual | |
Rastrea cómo se resuelven las propiedades de estilo para un control | |
Lee las propiedades del estilo activo para un control específico | |
Define estilos alternativos para controles específicos | |
Representa un `DelegateStyle` | |
Define el estilo para un delegado de subindicador | |
Define el estilo de texto para la etiqueta de un control | |
Define modificaciones de color y estilo para una combinación de colores |
Licencias
Qt Labs StyleKit está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.
© 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.