StyleReader QML Type

Lit les propriétés du style actif pour un contrôle spécifique. Plus d'informations...

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

Propriétés

• checked : bool
• controlType : enumeration
• enabled : bool
• focused : bool
• font : font
• global : ControlStyleProperties
• highlighted : bool
• hovered : bool
• palette : palette
• pressed : bool
• vertical : bool

Description détaillée

StyleReader est le pont entre un contrôle dans Qt Quick Controls et active style. Il expose toutes les propriétés de style - backgrounds, indicators, handles, text, padding, et plus encore - qu'un contrôle, et ses délégués, devraient lier. Tous les contrôles StyleKit intégrés utilisent un StyleReader en interne à cette fin.

Les propriétés d'état - hovered, pressed, focused, checked, highlighted, etc. - indiquent à StyleReader dans quel état se trouve le contrôle. Il les utilise pour résoudre et lire les valeurs de propriété correctes à partir de Style, en tenant compte de Themes, StyleVariations, fallback types et de la propagation des propriétés.

Lors de l'implémentation d'un CustomControl, vous pouvez suivre la même approche que les contrôles intégrés :

// Main.qml

component CustomButton : Rectangle {
    StyleReader {
        id: styleReader
        controlType: StyleReader.Button
        hovered: hoverHandler.hovered
        pressed: tapHandler.pressed
        palette: app.palette
    }

    implicitWidth: styleReader.background.implicitWidth
    implicitHeight: styleReader.background.implicitHeight
    color: styleReader.background.color
    radius: styleReader.background.radius

    HoverHandler { id: hoverHandler }
    TapHandler { id: tapHandler }

    Text {
        font: styleReader.font
        anchors.centerIn: parent
        text: "ok"
    }
}

Voir aussi CustomControl, Style, et StyleVariation.controlType.

Documentation sur les propriétés

checked : bool

Indique si le contrôle est vérifié.

Cette valeur est liée à la propriété checked du contrôle.

La valeur par défaut est false.

Voir aussi ControlStateStyle.checked.

controlType : enumeration

Identifie le type de contrôle du site Style dont le lecteur lit les propriétés. Cette valeur peut être définie comme l'une des valeurs prédéfinies ci-dessous ou comme une valeur custom control type définie dans le site Style.

Voir aussi StyleVariation.controlType.

enabled : bool

Indique si le contrôle est activé.

Cette valeur est liée à la propriété enabled du contrôle.

La valeur par défaut est true.

Voir aussi ControlStyleState.disabled.

focused : bool

Indique si le contrôle a un focus actif.

Cette valeur est liée à la propriété activeFocus du contrôle.

La valeur par défaut est false.

Voir également ControlStateStyle.focused.

font : font [read-only]

La police effective pour ce type de contrôle, telle qu'elle est définie par la propriété style. Elle prend également en compte les éventuelles dérogations de police définies dans les propriétés text du style.

Lier la propriété font du contrôle à cette propriété.

global : ControlStyleProperties [read-only]

Fournit un accès direct aux propriétés de style, en contournant toute transition en cours.

Lorsqu'une transition d'état est en cours, les propriétés de style lues à partir de StyleReader peuvent renvoyer des valeurs interpolées. En ajoutant global au chemin d'accès aux propriétés, vous contournez la transition et obtenez immédiatement les valeurs de l'état final.

Par exemple, lors de la transition de hovered à pressed, background.color peut renvoyer une valeur interpolée entre color dans l'état hovered et la couleur dans l'état pressed. global.background.color Par contre, la couleur de l'état pressé est renvoyée directement.

Voir aussi transitionsEnabled.

highlighted : bool

Indique si le contrôle est mis en évidence.

Lier ce paramètre à la propriété highlighted du contrôle.

La valeur par défaut est false.

Voir aussi ControlStateStyle.highlighted.

hovered : bool

Si le contrôle est survolé.

Liez ceci à la propriété hovered du contrôle.

La valeur par défaut est false.

Voir aussi ControlStateStyle.hovered.

palette : palette

La palette du contrôle. StyleKit l'utilise pour résoudre les propriétés de couleur qui lient palette à Style.

Lier cette propriété à la propriété palette du contrôle.

Voir également Style.palette.

pressed : bool

Indique si le contrôle est enfoncé.

Liez ceci à la propriété pressed du contrôle.

La valeur par défaut est false.

Voir aussi ControlStateStyle.pressed.

vertical : bool

Indique si le contrôle est orienté verticalement.

Lier ce paramètre à la valeur orientation du contrôle.

La valeur par défaut est false.

Voir également ControlStateStyle.vertical.