En esta página

Style QML Type

El tipo raíz de una definición de estilo. 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.

Propiedades

Descripción detallada

Style Es el tipo raíz de StyleKit para definir un estilo visual completo para los controles deQt Quick . Un estilo permite personalizar el aspecto de every control type — backgrounds, indicators, handles, text, padding y otros —, así como la forma en que los controles responden a estados como hovered, pressed y disabled, incluyendo animaciones transitions entre ellos.

Los estilos admiten esquemas de color light y dark a través de themes, y también puedes añadir cualquier número de custom themes. Los Style variations te permiten definir estilos alternativos que se pueden aplicar a instancias específicas de controles o a tipos de controles completos. También puedes definir custom controls para ampliar el estilo más allá del conjunto de controles integrado.

El siguiente ejemplo muestra un estilo mínimo que define algunas propiedades estructurales compartidas por todos los temas, con temas de colores claros y oscuros separados:

// PlainStyle.qml

import QtQuick
import Qt.labs.StyleKit

Style {
    control {
        padding: 6
        background {
            radius: 4
            width: 100
            height: 36
        }
        indicator {
            width: 20
            height: 20
            border.width: 1
        }
        handle {
            width: 20
            height: 20
            radius: 10
        }
    }

    button {
        background {
            width: 120
            shadow.opacity: 0.6
            shadow.verticalOffset: 2
            shadow.horizontalOffset: 2
            gradient: Gradient {
                GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
                GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
            }
        }
        pressed.background.scale: 0.95
    }

    slider {
        indicator.fillWidth: true
        indicator.height: 6
        indicator.radius: 3
    }

    light: Theme {
        applicationWindow {
            background.color: "whitesmoke"
        }
        control {
            text.color: "black"
            background.color: "#e8e8e8"
            background.border.color: "#c0c0c0"
            hovered.background.color: "#d0d0d0"
        }
        button {
            text.color: "white"
            background.color: "cornflowerblue"
            background.shadow.color: "gray"
            hovered.background.color: "royalblue"
        }
    }

    dark: Theme {
        applicationWindow {
            background.color: Qt.darker("gray", 2.0)
        }
        control {
            text.color: "white"
            background.color: "#3a3a3a"
            background.border.color: "#555555"
            hovered.background.color: "#4a4a4a"
        }
        button {
            background.color: "sandybrown"
            background.shadow.color: "black"
            hovered.background.color: Qt.darker("sandybrown", 1.2)
        }
    }
}

Para ver un ejemplo más completo, 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 Theme, CustomTheme, StyleVariation, ControlStyle, DelegateStyle, CustomControl y Resolución de propiedades de StyleKit.

Documentación de propiedades

availableThemeNames : list<string> [read-only]

Los nombres de todos los temas disponibles, incluidos "System", "Light", "Dark" y cualquier otro custom themes.

Véase también themeName y customThemeNames.

customThemeNames : list<string> [read-only]

Los nombres de todos los custom themes definidos en el estilo. Esto no incluye el built-in themes.

Véase también availableThemeNames, themeName y CustomTheme.

dark : Component

El componente de tema oscuro. Se crea y se aplica cuando el sistema está en modo oscuro y themeName es "System", o cuando themeName se establece explícitamente en "Dark".

dark: Theme {
    control.background.color: "#404040"
    button.hovered.background.color: "#6ab0f9"
}

Véase también light y themeName.

fallbackStyle : Style

El estilo de reserva se utiliza para resolver las propiedades que no se han definido explícitamente en este estilo. Cuando no se encuentra una propiedad en el estilo ni en su tema activo, StyleKit la busca en el estilo de reserva.

Por defecto, el estilo de reserva está configurado como un estilo interno que proporciona una apariencia básica similar al estilo «Basic ».

Puedes configurarlo como un estilo personalizado o como « null » para desactivar por completo la resolución de reserva. Ten en cuenta que configurarlo como « null » significa partir de cero, lo que te obligará a establecer muchas más propiedades de las que serían necesarias en otras circunstancias. Aquí puedes encontrar una implementación de referencia de un estilo de reserva .

light : Component

El componente de tema claro. Se instancia y se aplica cuando el sistema está en modo claro y themeName es "System", o cuando themeName se establece explícitamente en "Light".

light: Theme {
    control.background.color: "#f0f0f0"
    button.hovered.background.color: "#4a90d9"
}

Véase también dark y themeName.

palette : palette [read-only]

La paleta del control al que se le aplica el estilo.

Utiliza esta paleta para vincular los colores del estilo a la propiedad ` palette ` del control al que se le está aplicando el estilo. Si la aplicación asigna una paleta diferente a un control, el estilo se adaptará y el control se volverá a dibujar.

button.background.color: palette.accent
button.text.color: palette.buttonText

Véase también « StyleReader::palette ».

theme : Theme [read-only]

La instancia del tema actualmente activa. Se crea a partir de light theme component, dark theme component o uno de los archivos de custom themes, dependiendo de themeName.

Al resolver una propiedad de estilo, StyleKit la busca primero en este tema (excepto enStyleVariations ). Si no encuentra la propiedad, recurre a buscarla en Style.

Véase también themeName, light y dark.

themeName : string

El nombre del tema actualmente activo. El valor por defecto es "System", que elige automáticamente entre light o dark en función de la combinación de colores indicada en QStyleHints::colorScheme.

Puedes configurar esta propiedad para cambiar el tema actual de este estilo.

// Main.qml

StyleKit.style: YourStyleKitStyle {
    // Set a theme different from "System" at start-up
    themeName: "Dark"
}

ComboBox {
    // Let the user select a different theme at run-time
    model: StyleKit.style.availableThemeNames
    onCurrentTextChanged: StyleKit.style.themeName = currentText
}

Valores admitidos:

Nota: Los temas son locales para la Style en la que se definen y solo pueden establecerse como tema actual para ese estilo. Para que el tema actual surta efecto, el estilo al que pertenece también debe ser el current style en la aplicación.

Véase también « availableThemeNames » y « theme ».

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