StyleReader QML Type
Lee las propiedades del estilo activo de un control específico. Más...
| Import Statement: | import Qt.labs.StyleKit |
| Inherits: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
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 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.
| Constante | Descripción |
|---|---|
StyleReader.BusyIndicator | BusyIndicator |
StyleReader.Button | Button |
StyleReader.CheckBox | CheckBox |
StyleReader.CheckDelegate | CheckDelegate |
StyleReader.ComboBox | ComboBox |
StyleReader.DelayButton | DelayButton |
StyleReader.Dial | Dial |
StyleReader.Dialog | Dialog |
StyleReader.DialogButtonBox | DialogButtonBox |
StyleReader.Frame | Frame |
StyleReader.GroupBox | GroupBox |
StyleReader.ItemDelegate | ItemDelegate |
StyleReader.Label | Label |
StyleReader.Menu | Menu |
StyleReader.MenuBar | MenuBar |
StyleReader.MenuBarItem | MenuBarItem |
StyleReader.MenuItem | MenuItem |
StyleReader.MenuSeparator | MenuSeparator |
StyleReader.Page | Page |
StyleReader.PageIndicator | PageIndicator |
StyleReader.Pane | Pane |
StyleReader.Popup | Popup |
StyleReader.ProgressBar | ProgressBar |
StyleReader.RadioButton | RadioButton |
StyleReader.RadioDelegate | RadioDelegate |
StyleReader.RoundButton | RoundButton |
StyleReader.ScrollBar | ScrollBar |
StyleReader.ScrollView | ScrollView |
StyleReader.SearchField | SearchField |
StyleReader.Slider | Slider |
StyleReader.SpinBox | SpinBox |
StyleReader.SwipeDelegate | SwipeDelegate |
StyleReader.Switch | Switch |
StyleReader.SwitchDelegate | SwitchDelegate |
StyleReader.TabBar | TabBar |
StyleReader.TabButton | TabButton |
StyleReader.TextArea | TextArea |
StyleReader.TextField | TextField |
StyleReader.ToolBar | ToolBar |
StyleReader.ToolButton | ToolButton |
StyleReader.ToolSeparator | ToolSeparator |
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.