ControlStyleProperties QML Type
Define las propiedades de estilo de un control. Más información...
| Import Statement: | import Qt.labs.StyleKit |
| Inherited By: | ControlStateStyle, ControlStyle, CustomControl, and StyleReader |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- background : DelegateStyle
- bottomPadding : real
- handle : HandleStyle
- indicator : IndicatorStyle
- leftPadding : real
- padding : real
- rightPadding : real
- spacing : real
- text : TextStyle
- topPadding : real
- transition : Transition
Descripción detallada
ControlStyleProperties define las propiedades personalizables de un control: los componentes visuales background, indicator, handle y text, así como propiedades de diseño como padding, spacing y transition.
Se accede a las propiedades de estilo a través de tipos heredados como ControlStyle y StyleReader.
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, StyleReader, ControlStateStyle y DelegateStyle.
Documentación de propiedades
background : DelegateStyle
Propiedad agrupada para aplicar estilos al fondo de un control.
El delegado de fondo suele ser el rectángulo visual principal situado detrás del control. Úsalo para establecer colors, borders, radii, shadows, gradients y images.
Nota: El valor predeterminado de « fallback style » establece « background.visible » en « false » para los controles que, por lo general, no deben dibujar un fondo, como « CheckBox », « RadioButton » y « Slider ». Para mostrar su fondo, establezca « background.visible » en « true » de forma explícita.
bottomPadding : real
El bottom padding del control. Si no se especifica, se utiliza por defecto padding.
Véase también padding, topPadding, leftPadding y rightPadding.
handle : HandleStyle
Propiedad agrupada para aplicar estilos al controlador de un control.
El controlador es utilizado por controles como Switch, Slider y RangeSlider. En el caso de un RangeSlider, los dos controladores pueden personalizarse individualmente mediante handle.first y handle.second.
Véase también HandleStyle y DelegateStyle.
indicator : IndicatorStyle
Propiedad agrupada para aplicar estilos al indicador de un control. En el caso de un « checkBox », el indicador es el marco y su « foreground » es la marca de verificación. En el caso de un « slider », el indicador es la ranura y el «foreground» es el relleno.
Véase también « DelegateStyle ».
leftPadding : real
El left padding del control. Si no se especifica, se utiliza por defecto padding.
Véase también padding, rightPadding, topPadding y bottomPadding.
padding : real
El espaciado uniforme entre control's content area and the bounds of the control. Al configurarlo, se establece un valor por defecto para leftPadding, rightPadding, topPadding y bottomPadding. Cada lado se puede modificar de forma individual.
Véase también leftPadding, rightPadding, topPadding y bottomPadding.
rightPadding : real
El right padding del control. Si no se especifica, se utiliza por defecto padding.
Véase también padding, leftPadding, topPadding y bottomPadding.
spacing : real
El espacio entre los elementos visuales dentro del control, por ejemplo, entre un indicador y una etiqueta.
text : TextStyle
Propiedad agrupada para aplicar estilos a la etiqueta de texto de un control.
topPadding : real
El top padding del control. Si no se especifica, se utiliza por defecto padding.
Véase también padding, bottomPadding, leftPadding y rightPadding.
transition : Transition
Un « Transition » que se utiliza para animar las propiedades de estilo cuando el control entra en un nuevo estado, como « hovered » o « pressed ». Si se establece en « null » (valor por defecto), los cambios en las propiedades se aplican inmediatamente sin animación.
button {
background.color: "mistyrose"
hovered.background.color: "plum"
transition: Transition {
ColorAnimation {
properties: "background.color, background.shadow.color, handle.color"
easing.type: Easing.OutQuad
duration: 500
}
NumberAnimation {
properties: "background.leftRadius, background.rightRadius"
easing.type: Easing.OutQuad
duration: 500
}
}
// I only want a fade-out effect (not fade-in). So while the button
// is hovered, remove the transition, so that it only applies in the
// normal state. In other words, it's the state being entered that
// determines the transition, not the state that is left.
hovered.transition: null
}Para evitar repetir las mismas propiedades de destino en cada delegado, StyleKit proporciona StyleAnimation para mayor comodidad, que puede utilizarse en lugar de las animaciones estándar o en combinación con ellas :
comboBox {
background.color: "mistyrose"
hovered.background.color: "plum"
transition: Transition {
StyleAnimation {
animateColors: true
animateBackgroundRadii: true
animateIndicatorRadii: true
animateBackgroundShadow: true
easing.type: Easing.OutQuad
duration: 500
}
}
}Nota: Para las propiedades de color que participan en una transición, es preferible utilizar « Qt.alpha » en lugar de « "transparent" » (por ejemplo, menuBarItem.background.color: Qt.alpha(palette.accent, 0)). « "transparent" » es « Qt.rgba(0, 0, 0, 0) », lo que puede hacer que los colores interpolados se inclinen hacia el negro durante la transició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.