StyleKitDebug QML Type

Explique comment les propriétés de style sont appliquées à un contrôle. 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

• control : Item
• filter : string

Description détaillée

StyleKitDebug est un outil de diagnostic intégré à l’application qui consigne les lectures des propriétés de style dans la sortie de débogage. Il est utile pour comprendre pourquoi un contrôle présente une apparence particulière, notamment dans le cas de styles complexes impliquant plusieurs themes ou style variations.

Il est accessible via StyleKit.debug.

Pour lancer le traçage, attribuez le contrôle que vous souhaitez analyser à la propriété control:

ApplicationWindow {
    id: app
    width: 1024
    height: 800
    visible: true

    StyleKit.debug.control: someButton
    StyleKit.debug.filter: "background.color"

    StyleKit.style: Style {
        button {
            background.color: "gray"
            hovered.background.color: "dimgray"
        }
        dark: Theme {
            button {
                background.color: "skyblue"
                hovered.background.color: "lightblue"
            }
        }
    }

    Column {
        anchors.fill: parent
        anchors.margins: 10
        spacing: 10

        Button {
            id: someButton
            text: "A Button"
        }
    }
}

Chaque propriété résolue est affichée sur une ligne distincte indiquant d’où provient la valeur et en quoi elle a été résolue :

[read] StyleReader[Hovered].button.background.color -> Style.Theme(Dark).button[Hovered] = #add8e6

Le terme « StyleReader » dans la sortie fait référence à l’ StyleReader que l’ Button utilise en interne pour lire les valeurs de ses propriétés de style.

Le traçage des lectures de propriétés d’un « StyleReader » peut générer un volume important de données de sortie. Utilisez l’ filter pour limiter la sortie aux propriétés qui vous intéressent.

Voir également « StyleKit::debug » et « StyleKit Property Resolution ».

Documentation sur les propriétés

control : Item

L'identifiant de l'Control ou de l'StyleReader à suivre.

Lorsqu’il est défini, StyleKit consigne toutes les lectures de propriétés de style pour cet élément dans le journal de débogage. Définissez-le sur null pour arrêter le suivi.

Voir également filter.

filter : string

Expression régulière utilisée pour filtrer la sortie de débogage. Seules les lignes correspondant au motif sont affichées. Par défaut, toute la sortie est affichée.

Par exemple, pour ne tracer que la couleur d'arrière-plan :

StyleKit.debug.filter: "background.color"

Pour tracer toutes les couleurs d’arrière-plan, y compris les propriétés telles que background.color, background.border.color, background.image.color et background.shadow.color, utilisez l’expression régulière suivante :

StyleKit.debug.filter: "background.*color"

Voir également control.