ControlStyle QML Type

Définit le style d'un contrôle dans l'état normal. Plus d'informations...

• 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 la manière dont une page Control doit être stylisée. Son API reflète largement celle d'un contrôle Qt Quick: il fournit des propriétés groupées pour des 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 êtes familier avec l'API d'un contrôle Control dans Qt Quick, vous devriez trouver l'API de ControlStyle facile à suivre.

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'aspect du contrôle lorsqu'aucun autre état n'est actif. Les dérogations spécifiques à un état sont définies par le biais d'états imbriqués, tels que hovered pressed , et checked.

Each stylable control Dans un état Style, Theme, ou StyleVariation, un ControlStyle est défini. 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 {
            implicitWidth: 20
            implicitHeight: 20
            border.width: 1
        }
        handle {
            implicitWidth: 20
            implicitHeight: 20
            radius: 10
        }
    }

    button {
        background {
            implicitWidth: 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 aussi All stylable controls, Style, Theme, StyleVariation, ControlStateStyle, et DelegateStyle.

Documentation sur les propriétés

variations : list<StyleVariation>

Une liste de type variations pour ce type de contrôle.

Une variation de type fournit un style alternatif pour les contrôles qui sont des enfants (ou des descendants) de ce type de contrôle. Par exemple, vous pouvez l'utiliser pour styliser tous les buttons à l'intérieur d'un frame différemment des 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 sont appliquées à des instances de contrôle spécifiques à partir de l'application via la propriété StyleVariation::variations attached - les variations de type sont appliquées à toutes les instances d'un type de contrôle à partir de Style, sans que l'application n'ait besoin d'y participer.

Voir également StyleVariation.