Sur cette page

CustomTheme QML Type

Définit un thème personnalisé nommé. Plus d'informations...

Import Statement: import Qt.labs.StyleKit

Propriétés

Description détaillée

CustomTheme vous permet d'ajouter des thèmes supplémentaires à light et dark. Alors que les thèmes clair et foncé sont appliqués sur automatically en fonction du schéma de couleurs du système d'exploitation, un thème personnalisé 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 un nombre illimité de thèmes personnalisés à l'intérieur d'un site 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 thème personnalisé, attribuez son nom à Style::themeName à partir de l'application :

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

Vous pouvez également définir un thème personnalisé 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 au moment de l'exécution à partir de Style::customThemeNames ou Style::themeNames.

Note : La compatibilité des types dans les modules Qt.labs n'est pas garantie dans les versions futures.

Voir aussi Theme, Style::themeName, et Style::customThemeNames.

Documentation sur les propriétés

name : string

Le nom de ce thème. C'est 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 reviennent à celles définies dans le composant 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.