ControlStyleProperties QML Type

Définit les propriétés personnalisables d'un contrôle. En savoir plus...

Ce type est en préversion technologique et est susceptible d'être modifié.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• background : DelegateStyle
• bottomPadding : real
• handle : HandleStyle
• indicator : IndicatorStyle
• leftPadding : real
• padding : real
• rightPadding : real
• spacing : real
• text : TextStyle
• topPadding : real
• transition : Transition

Description détaillée

ControlStyleProperties définit les propriétés personnalisables d'un contrôle : les éléments visuels de base background, indicator, handle et text, ainsi que les propriétés de mise en page telles que padding, spacing et transition.

L'accès aux propriétés de style s'effectue via des types hérités tels que ControlStyle et StyleReader.

Voir également ControlStyle, StyleReader, ControlStateStyle et DelegateStyle.

Documentation sur les propriétés

background : DelegateStyle

Propriété groupée permettant de définir le style d'arrière-plan d'un contrôle.

Le délégué d’arrière-plan correspond généralement au rectangle visuel principal situé derrière le contrôle. Utilisez-le pour définir les propriétés suivantes : colors, borders, radii, shadows, gradients et images.

bottomPadding : real

bottom padding s du contrôle. Si ce paramètre n'est pas défini, la valeur par défaut est padding.

Voir également padding, topPadding, leftPadding et rightPadding.

handle : HandleStyle

Propriété groupée permettant de définir l'apparence de la poignée d'un contrôle.

La poignée est utilisée par des contrôles tels que Switch, Slider et RangeSlider. Pour un RangeSlider, les deux poignées peuvent être personnalisées individuellement via handle.first et handle.second.

Voir également HandleStyle et DelegateStyle.

indicator : IndicatorStyle

Propriété groupée permettant de définir l'apparence de l'indicateur d'un contrôle. Pour un « checkBox », l'indicateur correspond au cadre et son « foreground » à la coche. Pour un « slider », l'indicateur correspond à la rainure et le « foreground » au remplissage.

Voir également DelegateStyle.

leftPadding : real

left padding s du contrôle. Si ce paramètre n'est pas défini, la valeur par défaut est padding.

Voir également padding, rightPadding, topPadding et bottomPadding.

padding : real

L'espacement uniforme entre les control's content area and the bounds of the control. La définition de ce paramètre fournit une valeur par défaut pour leftPadding, rightPadding, topPadding et bottomPadding. Chaque côté peut être redéfini individuellement.

Voir également leftPadding, rightPadding, topPadding et bottomPadding.

rightPadding : real

right padding e du contrôle. Si elle n'est pas définie, la valeur par défaut est padding.

Voir également padding, leftPadding, topPadding et bottomPadding.

spacing : real

L'espacement entre les éléments visuels à l'intérieur du contrôle, par exemple entre un indicateur et une étiquette.

text : TextStyle

Propriété groupée permettant de styliser le libellé d'un contrôle.

topPadding : real

top padding s du contrôle. Si ce paramètre n'est pas défini, la valeur par défaut est padding.

Voir également padding, bottomPadding, leftPadding et rightPadding.

transition : Transition

Une propriété ` Transition ` permet d'animer les propriétés de style lorsque le contrôle passe à un nouvel état, par exemple ` hovered ` ou ` pressed`. Si cette propriété est définie sur ` null ` (valeur par défaut), les modifications de propriétés sont appliquées immédiatement, sans animation.

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
}

Pour éviter de répéter les mêmes propriétés cibles pour chaque délégué, StyleKit fournit, pour plus de commodité, ` StyleAnimation `, qui peut être utilisé à la place ou en combinaison avec les animations standard :

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
        }
    }
}