ControlStateStyle QML Type

Décrit le style d'un contrôle dans un état donné. Plus d'informations...

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

Propriétés

• checked : ControlStateStyle
• disabled : ControlStateStyle
• focused : ControlStateStyle
• highlighted : ControlStateStyle
• hovered : ControlStateStyle
• pressed : ControlStateStyle
• vertical : ControlStateStyle

Description détaillée

ControlStateStyle décrit le style d'un contrôle dans un état particulier. Un site ControlStyle hérite de ControlStateStyle, puisqu'il représente l'état normal - les propriétés définies directement sur un site ControlStyle décrivent l'aspect du contrôle lorsqu'aucun autre état n'est actif. Les dérogations spécifiques à un état sont ensuite définies par le biais d'états imbriqués tels que pressed, hovered et checked.

Les états imbriqués ne s'excluent pas mutuellement. Plusieurs états peuvent être actifs en même temps - par exemple, un bouton peut être survolé et pressé simultanément. Lorsque plusieurs états sont actifs, toutes les dérogations d'état correspondantes sont appliquées. Si la même propriété est définie dans plusieurs états actifs, les conflits sont résolus selon l'ordre de priorité suivant : pressed hovered , highlighted, focused, checked, vertical. Ainsi, par exemple, pressed.background.color l'emporte sur checked.background.color si le contrôle est à la fois pressed et checked.

L'état disabled est une exception : il n'est pas possible d'interagir avec un contrôle désactivé, de sorte que les états pressed, hovered, highlighted et focused ne s'appliquent pas. Cependant, disabled peut toujours être combiné avec des états tels que checked et vertical.

Plus un état est imbriqué, plus il est qualifié. Par exemple, hovered.pressed.background.color est prioritaire sur hovered.background.color lorsque hovered et pressed sont tous deux actifs. L'ordre d'imbrication n'a pas d'importance : hovered.pressed et pressed.hovered sont équivalents. Toutefois, si les deux formes sont utilisées en même temps, on ne sait pas laquelle l'emporte.

L'imbrication plus profonde des états peut également être utilisée pour résoudre les conflits. Si la même propriété est définie à la fois dans hovered et checked, l'ordre de priorité signifie que la valeur de hovered l'emporte. Si vous préférez que la valeur vérifiée l'emporte, ou que vous utilisiez une valeur totalement différente dans cette situation, vous pouvez remplacer la propriété dans hovered.checked, qui a alors la priorité sur les deux.

L'extrait suivant montre comment styliser un bouton différemment en fonction de son état :

button {
    text.color: "white"
    background.color: "cornflowerblue"

    pressed.background.color: "cadetblue"
    hovered.background.color: "dodgerblue"
    highlighted.background.color: "lightblue"
    focused.background.color: "lightskyblue"
    checked.background.color: "darkseagreen"
    disabled.background.color: "gray"

    // hovered.checked takes precedence over both hovered and checked
    hovered.checked.background.color: "mediumseagreen"

    hovered.checked {
        // Nested states are grouped properties, so you can use the compact
        // per-property form above, or structure them hierarchically for
        // better readability. Both forms are functionally equivalent.
        pressed {
            // hovered.checked.pressed takes precedence over hovered.checked
            background {
                color: "mediumaquamarine"
                scale: 0.95
            }
            text {
                bold: true
            }
        }
    }
}

Voir également ControlStyle, DelegateStyle, et FallbackStyle Reference.

Documentation sur les propriétés

checked : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est checked.

Voir également pressed, hovered, highlighted, focused, vertical, disabled, et StyleReader.checked.

disabled : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est désactivé.

Il n'est pas possible d'interagir avec un contrôle désactivé, de sorte que pressed, hovered, highlighted, et focused ne seront pas appliqués en même temps que le contrôle désactivé.

Voir aussi pressed, hovered, highlighted, focused, checked, vertical, et StyleReader.disabled.

focused : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est focused.

Voir également pressed, hovered, highlighted, checked, vertical, disabled, et StyleReader.focused.

highlighted : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est highlighted.

Voir également pressed, hovered, focused, checked, vertical, disabled, et StyleReader.highlighted.

hovered : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est hovered.

Voir également pressed, highlighted, focused, checked, vertical, disabled, et StyleReader.hovered.

pressed : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est pressed.

Voir également hovered, highlighted, focused, checked, vertical, disabled, et StyleReader.pressed.

vertical : ControlStateStyle

Remplacements de style appliqués lorsque le contrôle est vertical (par exemple, un contrôle vertical Slider ou ScrollBar).

Voir également pressed, hovered, highlighted, focused, checked, disabled, et StyleReader.vertical.