StyleReader QML Type

Lee las propiedades del Estilo activo para un control específico. Más...

• Lista de todos los miembros, incluyendo los heredados

Propiedades

• checked : bool
• controlType : enumeration
• enabled : bool
• focused : bool
• font : font
• global : ControlStyleProperties
• highlighted : bool
• hovered : bool
• palette : palette
• pressed : bool
• vertical : bool

Descripción detallada

StyleReader es el puente entre un control en Qt Quick Controls y active style. Expone todas las propiedades de estilo - backgrounds, indicators, handles, text, padding, y más - que un control, y sus delegados, deben enlazar. Todos los controles incorporados en StyleKit utilizan internamente un StyleReader para este propósito.

Las propiedades de estado - hovered, pressed, focused, checked, highlighted, etc. - indican al StyleReader en qué estado se encuentra el control. Utiliza estas propiedades para resolver y leer los valores correctos de Style, teniendo en cuenta Themes, StyleVariations, fallback types, y la propagación de propiedades.

Cuando se implementa un CustomControl, se puede seguir el mismo enfoque que con los controles incorporados:

// Main.qml

component CustomButton : Rectangle {
    StyleReader {
        id: styleReader
        controlType: StyleReader.Button
        hovered: hoverHandler.hovered
        pressed: tapHandler.pressed
        palette: app.palette
    }

    implicitWidth: styleReader.background.implicitWidth
    implicitHeight: styleReader.background.implicitHeight
    color: styleReader.background.color
    radius: styleReader.background.radius

    HoverHandler { id: hoverHandler }
    TapHandler { id: tapHandler }

    Text {
        font: styleReader.font
        anchors.centerIn: parent
        text: "ok"
    }
}

Véase también CustomControl, Style, y StyleVariation.controlType.

Documentación de propiedades

checked : bool

Si el control está marcado.

Vincule esto a la propiedad checked del control.

El valor por defecto es false.

Véase también ControlStateStyle.checked.

controlType : enumeration

Identifica de qué tipo de control de Style lee propiedades este lector. Puede definirse como uno de los valores predefinidos a continuación o como custom control type definido en Style.

Véase también StyleVariation.controlType.

enabled : bool

Si el control está habilitado.

Vincule esto a la propiedad enabled del control.

El valor por defecto es true.

Ver también la sección ControlStyleState.disabled.

focused : bool

Si el control tiene foco activo.

Vincule esto a la propiedad activeFocus del control.

El valor por defecto es false.

Véase también ControlStateStyle.focused.

font : font [read-only]

La fuente efectiva para este tipo de control, tal y como se define en style. Esto también tiene en cuenta cualquier sobreescritura de fuente establecida en las propiedades text del estilo.

Vincula la propiedad font del control a esta propiedad.

global : ControlStyleProperties [read-only]

Proporciona acceso directo a las propiedades de estilo, evitando cualquier transition en curso.

Durante una transición de estado, las propiedades de estilo leídas desde StyleReader pueden devolver valores interpolados. Si se antepone global a la ruta de la propiedad, se omite la transición y se obtienen inmediatamente los valores del estado final.

Por ejemplo, al pasar de hovered a pressed, background.color puede devolver un valor interpolado entre color en el estado hovered y el color en el estado pressed. global.background.color En cambio, devuelve directamente el color en el estado pulsado.

Véase también transitionsEnabled.

highlighted : bool

Si el control está resaltado.

Vincule esto a la propiedad highlighted del control.

El valor por defecto es false.

Véase también ControlStateStyle.highlighted.

hovered : bool

Si el control está sobrevolado.

Vincule esto a la propiedad hovered del control.

El valor por defecto es false.

Véase también ControlStateStyle.hovered.

palette : palette

La paleta del control. StyleKit utiliza esto para resolver las propiedades de color que enlazan el palette en el Style.

Vincula esto a la propiedad palette del control.

Véase también Style.palette.

pressed : bool

Si el control está pulsado.

Vincule esto a la propiedad pressed del control.

El valor por defecto es false.

Véase también ControlStateStyle.pressed.

vertical : bool

Si el control está orientado verticalmente.

Vincule esto al control orientation.

El valor por defecto es false.

Véase también ControlStateStyle.vertical.