ControlStyleProperties QML Type

Définit les propriétés stylisables d'un contrôle. Plus d'informations...

• 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 stylisables d'un contrôle : les éléments visuels background, indicator, handle, et text, ainsi que les propriétés de mise en page comme padding, spacing, et transition.

Les propriétés de style sont accessibles par le biais de types hérités tels que ControlStyle et StyleReader.

Voir aussi ControlStyle, StyleReader, ControlStateStyle, et DelegateStyle.

Documentation sur les propriétés

background : DelegateStyle

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

Le délégué de l'arrière-plan est généralement le rectangle visuel principal derrière le contrôle. Utilisez-le pour définir colors, borders, radii, shadows, gradients, et images.

bottomPadding : real

Le site bottom padding du contrôle. S'il n'est pas défini, il est ramené à padding.

Voir également padding, topPadding, leftPadding, et rightPadding.

handle : HandleStyle

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

La poignée est utilisée par des contrôles tels que Switch, Slider, et RangeSlider. Dans le cas d'un contrôle RangeSlider, les deux poignées peuvent être stylisées individuellement à l'aide de handle.first et handle.second.

Voir également HandleStyle et DelegateStyle.

indicator : IndicatorStyle

Propriété groupée permettant de styliser l'indicateur d'un contrôle. Pour un checkBox, l'indicateur est le cadre et son foreground est la coche. Pour un slider, l'indicateur est la rainure et l'avant-plan est le remplissage.

Voir également DelegateStyle.

leftPadding : real

Le site left padding du contrôle. S'il n'est pas défini, il est ramené à 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. Ce réglage fournit une valeur par défaut pour leftPadding, rightPadding, topPadding et bottomPadding. Chaque côté peut être modifié individuellement.

Voir aussi leftPadding, rightPadding, topPadding, et bottomPadding.

rightPadding : real

Le site right padding du contrôle. S'il n'est pas défini, il est ramené à 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 l'étiquette de texte d'un contrôle.

topPadding : real

Le site top padding du contrôle. S'il n'est pas défini, il est ramené à padding.

Voir également padding, bottomPadding, leftPadding, et rightPadding.

transition : Transition

Transition utilisé pour animer les propriétés de style lorsque le contrôle entre dans un nouvel état, tel que survolé ou appuyé. Si la valeur est null (valeur par défaut), les changements de propriétés sont appliqués 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 StyleAnimation par commodité, 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
        }
    }
}

Notez également que ColorAnimation possède une fonction spéciale qui anime toutes les propriétés de couleur qui ont été modifiées lors d'un changement d'état si property et properties ne sont pas activés.