Style QML Type
El tipo raíz de una definición de estilo. Más información...
| Import Statement: | import Qt.labs.StyleKit |
| Inherits: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- availableThemeNames : list<string>
- customThemeNames : list<string>
- dark : Component
- fallbackStyle : Style
- light : Component
- palette : palette
- theme : Theme
- themeName : string
Descripción detallada
Style Es el tipo raíz de StyleKit para definir un estilo visual completo para los controles deQt Quick . Un estilo permite personalizar el aspecto de every control type — backgrounds, indicators, handles, text, padding y otros —, así como la forma en que los controles responden a estados como hovered, pressed y disabled, incluyendo animaciones transitions entre ellos.
Los estilos admiten esquemas de color light y dark a través de themes, y también puedes añadir cualquier número de custom themes. Los Style variations te permiten definir estilos alternativos que se pueden aplicar a instancias específicas de controles o a tipos de controles completos. También puedes definir custom controls para ampliar el estilo más allá del conjunto de controles integrado.
El siguiente ejemplo muestra un estilo mínimo que define algunas propiedades estructurales compartidas por todos los temas, con temas de colores claros y oscuros separados:
// 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)
}
}
}Para ver un ejemplo más completo, consulta el ejemplo «StyleKit Quick Controls».
Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
Véase también Theme, CustomTheme, StyleVariation, ControlStyle, DelegateStyle, CustomControl y Resolución de propiedades de StyleKit.
Documentación de propiedades
availableThemeNames : list<string> [read-only]
Los nombres de todos los temas disponibles, incluidos "System", "Light", "Dark" y cualquier otro custom themes.
Véase también themeName y customThemeNames.
customThemeNames : list<string> [read-only]
Los nombres de todos los custom themes definidos en el estilo. Esto no incluye el built-in themes.
Véase también availableThemeNames, themeName y CustomTheme.
dark : Component
El componente de tema oscuro. Se crea y se aplica cuando el sistema está en modo oscuro y themeName es "System", o cuando themeName se establece explícitamente en "Dark".
dark: Theme {
control.background.color: "#404040"
button.hovered.background.color: "#6ab0f9"
}Véase también light y themeName.
fallbackStyle : Style
El estilo de reserva se utiliza para resolver las propiedades que no se han definido explícitamente en este estilo. Cuando no se encuentra una propiedad en el estilo ni en su tema activo, StyleKit la busca en el estilo de reserva.
Por defecto, el estilo de reserva está configurado como un estilo interno que proporciona una apariencia básica similar al estilo «Basic ».
Puedes configurarlo como un estilo personalizado o como « null » para desactivar por completo la resolución de reserva. Ten en cuenta que configurarlo como « null » significa partir de cero, lo que te obligará a establecer muchas más propiedades de las que serían necesarias en otras circunstancias. Aquí puedes encontrar una implementación de referencia de un estilo de reserva .
light : Component
El componente de tema claro. Se instancia y se aplica cuando el sistema está en modo claro y themeName es "System", o cuando themeName se establece explícitamente en "Light".
light: Theme {
control.background.color: "#f0f0f0"
button.hovered.background.color: "#4a90d9"
}Véase también dark y themeName.
palette : palette [read-only]
La paleta del control al que se le aplica el estilo.
Utiliza esta paleta para vincular los colores del estilo a la propiedad ` palette ` del control al que se le está aplicando el estilo. Si la aplicación asigna una paleta diferente a un control, el estilo se adaptará y el control se volverá a dibujar.
button.background.color: palette.accent
button.text.color: palette.buttonTextVéase también « StyleReader::palette ».
theme : Theme [read-only]
La instancia del tema actualmente activa. Se crea a partir de light theme component, dark theme component o uno de los archivos de custom themes, dependiendo de themeName.
Al resolver una propiedad de estilo, StyleKit la busca primero en este tema (excepto enStyleVariations ). Si no encuentra la propiedad, recurre a buscarla en Style.
Véase también themeName, light y dark.
themeName : string
El nombre del tema actualmente activo. El valor por defecto es "System", que elige automáticamente entre light o dark en función de la combinación de colores indicada en QStyleHints::colorScheme.
Puedes configurar esta propiedad para cambiar el tema actual de este estilo.
// Main.qml
StyleKit.style: YourStyleKitStyle {
// Set a theme different from "System" at start-up
themeName: "Dark"
}
ComboBox {
// Let the user select a different theme at run-time
model: StyleKit.style.availableThemeNames
onCurrentTextChanged: StyleKit.style.themeName = currentText
}Valores admitidos:
"System"— sigue QStyleHints::colorScheme (por defecto)"Light"— fuerza el tema de light"Dark"— fuerza el tema de dark- Any custom theme name
Nota: Los temas son locales para la Style en la que se definen y solo pueden establecerse como tema actual para ese estilo. Para que el tema actual surta efecto, el estilo al que pertenece también debe ser el current style en la aplicación.
Véase también « availableThemeNames » y « theme ».
© 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.