En esta página

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

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.