Sur cette page

CustomTheme QML Type

Définit un thème personnalisé nommé. En savoir plus...

Import Statement: import Qt.labs.StyleKit
Status: Technology preview

Ce type est en préversion technique et est susceptible d'être modifié.

Propriétés

Description détaillée

CustomTheme vous permet d'ajouter des thèmes supplémentaires en plus de light et dark. Alors que les thèmes clair et foncé sont appliqués automatically en fonction de la palette de couleurs du système d'exploitation, un CustomTheme doit être activé explicitement par l'application. Hormis cette différence, tous les thèmes fonctionnent de la même manière.

Vous pouvez définir autant de thèmes personnalisés que vous le souhaitez au sein d’un Style.

Style {
    CustomTheme {
        name: "HighContrast"
        theme: Theme {
            control.background.color: "white"
            control.background.border.color: "black"
            control.background.border.width: 2
        }
    }

    CustomTheme {
        name: "Sepia"
        theme: Theme {
            control.text.color: "#5b4636"
            control.background.color: "#f4ecd8"
            control.background.border.color: "#c8b99a"
            applicationWindow.background.color: "#efe6d0"
        }
    }
}

Pour activer un CustomTheme, définissez Style::themeName sur son nom depuis l’application :

ComboBox {
    model: StyleKit.style.availableThemeNames
    onCurrentTextChanged: StyleKit.style.themeName = currentText
}

Vous pouvez également définir un CustomTheme comme thème par défaut au démarrage :

ApplicationWindow {
    width: 1024
    height: 800
    visible: true

    StyleKit.style: MyStyleKitStyle {
        themeName: "HighContrast"
    }
}

Les thèmes personnalisés définis dans un Style peuvent être interrogés à l’exécution via ` Style::customThemeNames ` ou ` Style::availableThemeNames`.

Remarque : la compatibilité des types dans les modules Qt.labs n’est pas garantie dans les versions futures.

Voir également Theme, Style::themeName et Style::customThemeNames.

Documentation sur les propriétés

name : string

Le nom de ce thème. Il s'agit de la valeur que vous attribuez à Style::themeName pour l'activer.

theme : Component

Le composant « Theme » qui définit le thème. Il ne sera instancié que lorsque le thème sera activé.

Les propriétés non définies dans le thème reprennent par défaut celles définies dans ` Style`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.