En esta página

Theme QML Type

Define las modificaciones de color y estilo para una combinación de colores. Más información...

Import Statement: import Qt.labs.StyleKit
Inherits:

AbstractStyle

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Descripción detallada

Un tema anula las propiedades definidas en un « Style » para proporcionar una apariencia visual distintiva a un esquema de color concreto. Normalmente, un estilo configura propiedades estructurales como el tamaño implícito, el relleno y los radios, mientras que un tema especifica colores, sombras y otros atributos visuales. Sin embargo, esto no supone una restricción: un tema puede anular cualquier propiedad que un estilo pueda establecer.

Un estilo puede proporcionar un tema « light » y un tema « dark ». Cuando « themeName » está establecido en « "System" » (valor predeterminado), el tema activo sigue el tema « operating system's color scheme ». También se pueden crear temas adicionales utilizando « CustomTheme » y « switch between them » en tiempo de ejecución.

Las propiedades que no se hayan establecido en el tema se sustituyen por las definidas en Style.

El siguiente ejemplo define los temas «light», «dark» y «high-contrast», cada uno de los cuales proporciona colores diferentes para los controles:

Style {
    light: Theme {
        control {
            text.color: "#202020"
            background.color: "#f0f0f0"
            background.border.color: "#d0d0d0"
            background.shadow.color: "#c0c0c0"
            hovered.background.color: "#e0e0e0"
        }
        applicationWindow.background.color: "gainsboro"
        button.hovered.background.color: "#4a90d9"
        radioButton.indicator.foreground.color: "#d0d0d0"
        switchControl.indicator.foreground.color: "lightslategray"
        switchControl.handle.color: "white"
    }

    dark: Theme {
        control {
            text.color: "#e0e0e0"
            background.color: "#404040"
            background.border.color: "#606060"
            background.shadow.color: "#222222"
            hovered.background.color: "#505050"
        }
        applicationWindow.background.color: "#2b2b2b"
        button.hovered.background.color: "#6ab0f9"
        radioButton.indicator.foreground.color: "#606060"
        switchControl.indicator.foreground.color: "#505050"
        switchControl.handle.color: "#808080"
    }

    CustomTheme {
        name: "HighContrast"
        theme: Theme {
            control {
                text.color: "black"
                text.bold: true
                background.color: "white"
                background.border.color: "black"
                background.border.width: 3
                background.shadow.visible: false
                hovered.background.border.width: 5
            }
            applicationWindow.background.color: "white"
            itemDelegate.hovered.text.color: "white"
            itemDelegate.hovered.background.color: "black"
            itemDelegate.background.border.width: 0
            button.hovered.background.color: "black"
            button.hovered.text.color: "white"
            radioButton.indicator.foreground.color: "white"
            radioButton.checked.indicator.foreground.color: "black"
            switchControl.indicator.foreground.color: "white"
            switchControl.handle.color: "white"
            switchControl.handle.border.color: "black"
            switchControl.handle.border.width: 2
            switchControl.checked.handle.color: "black"
        }
    }
}

Para ver un ejemplo completo que muestra los temas en acción, consulta el ejemplo «StyleKit Quick Controls».

Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.

Véase también « Style », « CustomTheme » y «Resolución de propiedades de StyleKit».

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