ControlStyle QML Type

Définit le style d'un contrôle à l'état « normal ». 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

• variations : list<StyleVariation>

Description détaillée

Un ControlStyle décrit l'apparence qu'un Control doit avoir. Son API reflète largement celle d'un contrôle Qt Quick: elle fournit des propriétés regroupées pour les délégués tels que background, indicator, handle et text, ainsi que des propriétés de mise en page telles que padding et spacing. Si vous connaissez bien l'API d'un Control dans Qt Quick Controls, vous devriez trouver l'API de ControlStyle facile à comprendre.

ControlStyle hérite de ControlStateStyle car il représente l’état normal: les propriétés définies directement sur un ControlStyle décrivent l’apparence du contrôle lorsqu’aucun autre état n’est actif. Les remplacements spécifiques à un état sont définis via des états imbriqués, tels que hovered, pressed et checked.

Each stylable control Dans un Style, Theme ou StyleVariation, il s’agit d’un ControlStyle. Par exemple, dans l’extrait ci-dessous, control, button et radioButton sont tous des ControlStyles :

Style {
    control {
        padding: 6
        text {
            color: "white"
        }
        background {
            radius: 4
            border.color: "gray"
        }
        indicator {
            width: 20
            height: 20
            border.width: 1
        }
        handle {
            width: 20
            height: 20
            radius: 10
        }
    }

    button {
        background {
            width: 120
            shadow.opacity: 0.6
            shadow.verticalOffset: 2
            shadow.horizontalOffset: 2
            shadow.color: "gray"
            color: "lightsteelblue"
            gradient: Gradient {
                GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
                GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
            }
        }
        hovered {
            background.color: "lightslategrey"
        }
        pressed {
            background.scale: 0.95
        }
    }

    radioButton {
    }

    checkBox {
    }

    slider {
    }

    // etc...
}

Voir également All stylable controls, Style, Theme, StyleVariation, ControlStateStyle et DelegateStyle.

Documentation relative aux propriétés

variations : list<StyleVariation>

Liste des « type variations » pour ce type de contrôle.

Une variation de type permet d’appliquer un style alternatif aux contrôles qui sont des enfants (ou des descendants) de ce type de contrôle. Par exemple, vous pouvez l’utiliser pour styliser différemment tous les contrôles « buttons » à l’intérieur d’un « frame » par rapport aux boutons situés ailleurs :

Style {
    frame {
        variations: StyleVariation {
            button {
                text.color: "ghostwhite"
                background.border.width: 0
                background.color: "slategrey"
            }
        }
    }

    groupBox {
        // groupBox falls back to frame. Therefore, if the varations set on a
        // frame is not wanted on a groupBox, just override it and set it back to [].
        variations: []
    }
}

Contrairement aux variations d’instance — qui s’appliquent à des instances spécifiques d’un contrôle au sein de l’application via la propriété attachée « StyleVariation::variations » —, les variations de type s’appliquent à toutes les instances d’un type de contrôle au sein de l’ Style, sans que l’application ait besoin d’activer cette fonctionnalité.

Voir également StyleVariation.