Auf dieser Seite

CustomTheme QML Type

Definiert ein benanntes benutzerdefiniertes Thema. Mehr...

Import Statement: import Qt.labs.StyleKit

Eigenschaften

Ausführliche Beschreibung

Mit CustomTheme können Sie zusätzliche Themes über light und dark hinaus hinzufügen. Während die hellen und dunklen Themes automatically basierend auf dem Farbschema des Betriebssystems angewendet werden, muss ein CustomTheme explizit von der Anwendung aktiviert werden. Abgesehen von diesem Unterschied funktionieren alle Themes auf die gleiche Weise.

Sie können eine beliebige Anzahl von CustomThemes in einem Style definieren.

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"
        }
    }
}

Um ein CustomTheme zu aktivieren, setzen Sie Style::themeName auf seinen Namen aus der Anwendung:

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

Sie können ein benutzerdefiniertes Thema auch als Standardthema beim Start festlegen:

ApplicationWindow {
    width: 1024
    height: 800
    visible: true

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

Die in einem Style definierten CustomThemes können zur Laufzeit über Style::customThemeNames oder Style::themeNames abgefragt werden.

Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

Siehe auch Theme, Style::themeName, und Style::customThemeNames.

Dokumentation der Eigenschaften

name : string

Der Name dieses Themas. Dies ist der Wert, den Sie Style::themeName zuweisen, um es zu aktivieren.

theme : Component

Die Komponente Theme, die das Thema definiert. Sie wird nur instanziiert, wenn das Thema aktiviert ist.

Eigenschaften, die nicht im Thema festgelegt sind, fallen auf die im Style definierten zurück.

© 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.