ControlStateStyle QML Type
Describe el estilo de un control en un estado determinado. Más información...
| Import Statement: | import Qt.labs.StyleKit |
| Inherits: | |
| Inherited By: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- checked : ControlStateStyle
- disabled : ControlStateStyle
- focused : ControlStateStyle
- highlighted : ControlStateStyle
- hovered : ControlStateStyle
- pressed : ControlStateStyle
- vertical : ControlStateStyle
Descripción detallada
ControlStateStyle describe el estilo de un control en un estado concreto. Un ` ControlStyle ` hereda de `ControlStateStyle`, ya que representa el estado normal: las propiedades establecidas directamente en un ` ControlStyle ` describen el aspecto del control cuando ningún otro estado está activo. Las modificaciones específicas de cada estado se establecen a través de estados anidados, como ` pressed`, ` hovered` y ` checked`.
Los estados anidados no son mutuamente excluyentes. Pueden estar activos varios estados al mismo tiempo; por ejemplo, un botón puede estar al pasar el cursor por encima y pulsado simultáneamente. Cuando hay varios estados activos, se aplican todas las modificaciones de estado que coincidan. Si la misma propiedad está definida en varios estados activos, los conflictos se resuelven siguiendo el siguiente orden de prioridad: pressed, hovered, highlighted, focused, checked, vertical. Así, por ejemplo, pressed.background.color tiene prioridad sobre checked.background.color si el control se encuentra a la vez en pressed y en checked.
El estado « disabled » es una excepción: no se puede interactuar con un control desactivado, por lo que los estados « pressed », « hovered », « highlighted » y « focused » no se aplicarán. Sin embargo, « disabled » sí se puede combinar con estados como « checked » y « vertical ».
Cuanto más anidado esté un estado, más específico será. Por ejemplo, hovered.pressed.background.color tiene prioridad sobre hovered.background.color cuando tanto hovered como pressed están activos. El orden de anidamiento no importa: hovered.pressed y pressed.hovered son equivalentes. Sin embargo, si se utilizan ambas formas al mismo tiempo, no está definido cuál prevalece.
También se puede recurrir a un anidamiento más profundo de los estados para resolver conflictos. Si la misma propiedad se establece tanto en hovered como en checked, el orden de prioridad hace que prevalezca el valor de hovered. Si prefieres que prevalezca el valor de «checked», o utilizar un valor totalmente diferente en esa situación, puedes sobrescribir la propiedad en hovered.checked, que entonces tendrá prioridad sobre ambas.
El siguiente fragmento de código muestra cómo aplicar un estilo diferente a un botón en función de su estado:
button {
text.color: "white"
background.color: "cornflowerblue"
pressed.background.color: "cadetblue"
hovered.background.color: "dodgerblue"
highlighted.background.color: "lightblue"
focused.background.color: "lightskyblue"
checked.background.color: "darkseagreen"
disabled.background.color: "gray"
// hovered.checked takes precedence over both hovered and checked
hovered.checked.background.color: "mediumseagreen"
hovered.checked {
// Nested states are grouped properties, so you can use the compact
// per-property form above, or structure them hierarchically for
// better readability. Both forms are functionally equivalent.
pressed {
// hovered.checked.pressed takes precedence over hovered.checked
background {
color: "mediumaquamarine"
scale: 0.95
}
text {
bold: true
}
}
}
}Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
Véase también ControlStyle, DelegateStyle, Resolución de propiedades de StyleKit y Referencia de FallbackStyle.
Documentación de propiedades
checked : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está en estado « checked ».
Véase también pressed, hovered, highlighted, focused, vertical, disabled y StyleReader.checked.
disabled : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está desactivado.
No se puede interactuar con un control desactivado, por lo que pressed, hovered, highlighted y focused no se aplicarán al mismo tiempo que la desactivación.
Véase también pressed, hovered, highlighted, focused, checked, vertical y StyleReader.enabled.
focused : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está en « focused ».
Véase también pressed, hovered, highlighted, checked, vertical, disabled y StyleReader.focused.
highlighted : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está en estado « highlighted ».
Véase también pressed, hovered, focused, checked, vertical, disabled y StyleReader.highlighted.
hovered : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está en estado « hovered ».
Véase también pressed, highlighted, focused, checked, vertical, disabled y StyleReader.hovered.
pressed : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control está en estado « pressed ».
Véase también hovered, highlighted, focused, checked, vertical, disabled y StyleReader.pressed.
vertical : ControlStateStyle
Las modificaciones de estilo se aplican cuando el control es de tipo « vertical » (por ejemplo, un « Slider » vertical o un « ScrollBar »).
Véase también pressed, hovered, highlighted, focused, checked, disabled y StyleReader.vertical.
© 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.