En esta página

StyleReader QML Type

Lee las propiedades del estilo activo de un control específico. Más...

Import Statement: import Qt.labs.StyleKit
Inherits:

ControlStyleProperties

Status: Technology preview

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

Propiedades

Descripción detallada

StyleReader es el puente entre un control de Qt Quick Controls y active style. Expone todas las propiedades de estilo — backgrounds, indicators, handles, text, padding y otras— a las que un control, y sus delegados, deben vincularse. Todos los controles integrados de StyleKit utilizan internamente un StyleReader para este fin.

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

Al implementar un ` CustomControl`, puedes seguir el mismo enfoque que los controles integrados:

// Main.qml

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

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

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

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

Nota: Las propiedades de estilo heredadas de ControlStyleProperties no se asignan directamente a Style. En su lugar, reflejan una caché de valores potencialmente interpolados durante una transición activa transition. Escribir en ellas no actualizará las propiedades correspondientes en Style y puede interferir con las transiciones en curso. Escribe directamente en Style cuando necesites cambiar una propiedad de estilo.

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

Véase también CustomControl, Style, StyleVariation.controlType y Resolución de propiedades de StyleKit.

Documentación de propiedades

checked : bool

Si el control está marcado.

Asigna 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 la página Style lee las propiedades este lector. Se puede establecer en uno de los valores predefinidos que se indican a continuación o en un custom control type definido en Style.

ConstanteDescripción
StyleReader.BusyIndicatorBusyIndicator
StyleReader.ButtonButton
StyleReader.CheckBoxCheckBox
StyleReader.CheckDelegateCheckDelegate
StyleReader.ComboBoxComboBox
StyleReader.DelayButtonDelayButton
StyleReader.DialDial
StyleReader.DialogDialog
StyleReader.DialogButtonBoxDialogButtonBox
StyleReader.FrameFrame
StyleReader.GroupBoxGroupBox
StyleReader.ItemDelegateItemDelegate
StyleReader.LabelLabel
StyleReader.MenuMenu
StyleReader.MenuBarMenuBar
StyleReader.MenuBarItemMenuBarItem
StyleReader.MenuItemMenuItem
StyleReader.MenuSeparatorMenuSeparator
StyleReader.PagePage
StyleReader.PageIndicatorPageIndicator
StyleReader.PanePane
StyleReader.PopupPopup
StyleReader.ProgressBarProgressBar
StyleReader.RadioButtonRadioButton
StyleReader.RadioDelegateRadioDelegate
StyleReader.RoundButtonRoundButton
StyleReader.ScrollBarScrollBar
StyleReader.ScrollViewScrollView
StyleReader.SearchFieldSearchField
StyleReader.SliderSlider
StyleReader.SpinBoxSpinBox
StyleReader.SwipeDelegateSwipeDelegate
StyleReader.SwitchSwitch
StyleReader.SwitchDelegateSwitchDelegate
StyleReader.TabBarTabBar
StyleReader.TabButtonTabButton
StyleReader.TextAreaTextArea
StyleReader.TextFieldTextField
StyleReader.ToolBarToolBar
StyleReader.ToolButtonToolButton
StyleReader.ToolSeparatorToolSeparator

Véase también StyleVariation.controlType.

enabled : bool

Si el control está habilitado.

Asigna esto a la propiedad « enabled » del control.

El valor por defecto es true.

Véase también ControlStateStyle.disabled.

focused : bool

Si el control tiene el foco activo.

Asigna 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 sustitución de fuente establecida en las propiedades text del estilo.

Vincula la propiedad font del control a esta propiedad.

Nota: A diferencia de propiedades como « hovered », « pressed » y « palette » —que se reenvían desde el control a « StyleReader »—, «font» es una salida. Vincula la propiedad « font » del control a este valor, y no al revés.

global : ControlStyleProperties [read-only]

Proporciona acceso directo a las propiedades de estilo, sin pasar por ningún proceso de transition en curso.

Mientras se está produciendo una transición de estado, las propiedades de estilo leídas desde un StyleReader pueden devolver valores interpolados. Al anteponer 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 el color del estado hovered y el color del estado pressed. global.background.color, por su parte, devuelve directamente el color del estado «pulsado».

Véase también transitionsEnabled.

highlighted : bool

Si el control está resaltado.

Asigna esto a la propiedad « highlighted » del control.

El valor por defecto es ` false`.

Véase también « ControlStateStyle.highlighted ».

hovered : bool

Si el cursor se encuentra sobre el control.

Asigna 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 la utiliza para resolver las propiedades de color que se vinculan a la propiedad ` palette ` en ` Style`.

Vincula esto a la propiedad ` palette ` del control.

Véase también « Style.palette ».

pressed : bool

Si se ha pulsado el control.

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

Asigna este valor a la propiedad « orientation » del control.

El valor por defecto es false.

Véase también ControlStateStyle.vertical.

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