En esta página

CustomControl QML Type

Define el estilo de un control personalizado (no integrado). Más información...

Import Statement: import Qt.labs.StyleKit
Inherits:

ControlStyle

Status: Technology preview

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

Propiedades

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.