CustomControl QML Type
Define el estilo de un control personalizado (no integrado). Más información...
| 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
- controlType : int
Descripción detallada
CustomControl te permite definir y aplicar estilos a controles que no forman parte de los controles deQt Quick . Esto resulta útil si dispones de controles o componentes adicionales a los que se les debe aplicar un estilo acorde con el Style y el Theme activos.
Al igual que los tipos de control integrados (como abstractButton, pane y slider), CustomControl hereda de ControlStyle. A diferencia de los tipos integrados, que están vinculados implícitamente a su tipo de control, un CustomControl requiere que se establezca explícitamente controlType. Aparte de eso, funcionan exactamente de la misma manera.
Un ` Style ` o un ` Theme ` puede definir tantos controles personalizados como sea necesario, y un `CustomControl` de un `Theme` puede tener el mismo ` controlType ` que uno de la clase ` Style`. Esto no difiere, por ejemplo, de que un ` slider ` reciba estilos tanto del ` Style ` como del ` Theme`. La lógica de sustitución es la misma.
Cualquier propiedad de estilo que no se haya establecido en un `CustomControl` se sustituye por las establecidas en un ` control`.
El siguiente fragmento de código muestra cómo definir el estilo de un control personalizado:
// MyStyle.qml
Style {
id: style
readonly property int myControlType: 0
CustomControl {
controlType: style.myControlType
background {
width: 120
height: 30
radius: 0
}
hovered.background.color: "lightslategray"
pressed.background.color: "skyblue"
}
}Y el siguiente fragmento de código muestra un ejemplo de cómo implementar un control personalizado que lo utilice:
// Main.qml
component MyControl : Rectangle {
StyleReader {
id: styleReader
controlType: StyleKit.style.myControlType
hovered: hoverHandler.hovered
pressed: tapHandler.pressed
palette: app.palette
}
HoverHandler { id: hoverHandler }
TapHandler { id: tapHandler }
implicitWidth: styleReader.background.width
implicitHeight: styleReader.background.height
color: styleReader.background.color
radius: styleReader.background.radius
Text {
font: styleReader.font
anchors.centerIn: parent
text: "ok"
}
}Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
Véase también StyleReader, ControlStyle, Style y StylableControls::getControlStyle().
Documentación de la propiedad
controlType : int
Un número entero único que identifica este tipo de control personalizado. Establece el mismo valor en la propiedad ` StyleReader.controlType ` de tu implementación del control personalizado para vincularlo a esta definición de estilo.
Los tipos de control personalizados deben estar comprendidos en el intervalo 0 a 100000.
Véase también StyleReader.controlType y StylableControls::getControlStyle().
© 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.