Auf dieser Seite

CustomTheme QML Type

Definiert ein benanntes benutzerdefiniertes Design. Mehr...

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

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

Eigenschaften

Ausführliche Beschreibung

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

Sie können beliebig viele benutzerdefinierte Designs innerhalb eines „ 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 in der Anwendung auf dessen Namen:

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

Sie können ein CustomTheme auch beim Start als Standard-Theme festlegen:

ApplicationWindow {
    width: 1024
    height: 800
    visible: true

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

Die in einem „Style“ definierten benutzerdefinierten Designs können zur Laufzeit über „ Style::customThemeNames “ oder „ Style::availableThemeNames “ abgefragt werden.

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

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

Dokumentation zu den Eigenschaften

name : string

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

theme : Component

Die Komponente „ Theme “, die das Theme definiert. Sie wird erst instanziiert, wenn das Theme aktiviert wird.

Eigenschaften, die im Theme nicht festgelegt sind, werden auf die in der „ Style “ definierten Werte zurückgesetzt.

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