En esta página

DelegateStyle QML Type

Define el aspecto visual de un elemento dentro de un control. Más información...

Import Statement: import Qt.labs.StyleKit
Inherited By:

HandleStyle, IndicatorStyle, and SubIndicatorStyle

Status: Technology preview

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

Propiedades

Descripción detallada

DelegateStyle describe el aspecto visual de un elemento visual dentro de un ControlStyle, como su background, indicator o un subelemento como indicator.foreground. Proporciona propiedades para controlar size, color, border, radius, shadow, image, opacity y mucho más.

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

Véase también ControlStyle, ControlStateStyle y la Referencia de FallbackStyle.

Documentación de propiedades

alignment : Qt::Alignment

La alineación del delegado dentro de su elemento padre. El valor por defecto es « Qt.AlignLeft | Qt.AlignVCenter ».

border : BorderStyle

Propiedad agrupada para aplicar estilos al borde de este delegado.

bottomLeftRadius : real

El radio de la esquina inferior izquierda. Si no se especifica, se utiliza por defecto el valor « radius ».

Véase también radius, topLeftRadius, topRightRadius y bottomRightRadius.

bottomMargin : real

El margen inferior de este delegado. Si no se especifica, se utiliza por defecto margins.

Véase también margins, topMargin, leftMargin y rightMargin.

bottomRightRadius : real

El radio de la esquina inferior derecha. Si no se especifica, se utiliza por defecto radius.

Véase también radius, topLeftRadius, topRightRadius y bottomLeftRadius.

clip : bool

Si el delegado recorta su contenido. El valor por defecto es « false ».

color : color

El color de relleno de este delegado. El valor por defecto es transparent.

A diferencia de un «Quick Rectangle », en el que un degradado sustituye al color, StyleKit dibuja el « gradient » sobre el color. Esto significa que puedes utilizar un degradado semitransparente como superposición (por ejemplo, un efecto de sombreado sutil) mientras que el color se ve a través de él.

button {
    background.gradient: Gradient {
        GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
        GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
    }
    background.color: "lightsteelblue"
    hovered.background.color: Qt.darker("lightsteelblue", 1.1)
    pressed.background.color: Qt.darker("lightsteelblue", 1.2)
}

Véase también « gradient » y « opacity ».

data : QObject

Un objeto arbitrario que se puede utilizar para pasar datos personalizados desde el estilo a un componente personalizado de delegate.

Esto te permite definir propiedades de estilo personalizadas más allá de lo que ofrece la API de StyleKit. El objeto de datos puede variar según los estados y los temas, lo que permite aplicar estilos a elementos de un « delegate » personalizado que no están cubiertos por las propiedades integradas.

El siguiente fragmento de código utiliza un delegado personalizado que dibuja un control « Text » superpuesto cuyo color varía en función del estado del control. El delegado hereda de ` StyledItem`, lo cual es opcional pero garantiza que el resto del fondo del botón se represente con normalidad.

component OverlayData : QtObject {
    property color overlayColor
}

toolButton {
    background.delegate: StyledItem {
        id: custom
        Text {
            color: custom.delegateStyle.data.overlayColor
            font.pixelSize: 30
            text: "シ"
        }
    }
    background.data: OverlayData {
        overlayColor: "sandybrown"
    }
    hovered.background.data: OverlayData {
        overlayColor: "magenta"
    }
}

Nota: El objeto ` data ` se propaga en su conjunto. A diferencia de las propiedades de estilo habituales, las propiedades individuales dentro del objeto de datos no se propagan por separado.

Véase también delegate.

delegate : Component

El delegado utilizado para mostrar el elemento « DelegateStyle » en un control «Qt Quick ».

El valor predeterminado es null; en ese caso, se utiliza StyledItem para la visualización. Si desea ocultar el delegado por completo (y evitar que se cree), establezca visible en false.

El delegado debe definir las siguientes propiedades obligatorias:

required property DelegateStyle delegateStyle
required property QtObject control

delegateStyle apunta a la propiedad « DelegateStyle », que describe cómo debe aplicarse el estilo al delegado. « control » apunta al control «Qt Quick » al que pertenece el delegado. Este último puede utilizarse para obtener información adicional sobre el control que no está disponible en el estilo.

Si conoces el tipo específico del control propietario, puedes utilizarlo en lugar de ` QtObject ` para la propiedad ` control `. Por ejemplo, dado que un delegado de controlador en el fragmento de código siguiente siempre se utiliza dentro de un `Slider`, el tipo se puede establecer en ` T.Slider`:

// import QtQuick.Templates as T

slider {
    handle.delegate: Rectangle {
        id: handle
        required property DelegateStyle delegateStyle
        required property T.Slider control
        implicitWidth: delegateStyle.width
        implicitHeight: delegateStyle.height
        radius: delegateStyle.radius
        color: delegateStyle.color
        Text {
            anchors.centerIn: parent
            text: handle.control.value.toFixed(0)
        }
    }
}

Nota: Si un « DelegateStyle » tiene definido un « drop shadow », se dibujará por separado mediante un shadow delegate.

Véase también « data », « visible » y « StyledItem ».

fillHeight : bool

Si el delegado debe ocupar toda la altura disponible del elemento principal.

A menudo se espera que algunos delegados, como el primer plano de un indicador de casilla de selección, ocupen toda la altura (y anchura) disponible del indicador, en lugar de tener una altura fija. Esto se puede conseguir estableciendo fillHeight en true. Para añadir algo de espacio entre el delegado y los bordes de su elemento padre, utiliza las propiedades margins.

Si fillHeight es false, la altura del delegado viene determinada por su height.

Véase también « fillWidth » y « height ».

fillWidth : bool

Si el delegado debe ocupar todo el ancho disponible del elemento padre.

A menudo se espera que algunos delegados, como la ranura de un « Slider », ocupen todo el ancho disponible del control, en lugar de tener un ancho implícito fijo. Esto se puede conseguir estableciendo la propiedad « fillWidth » en « true ». Para añadir algo de espacio entre el delegado y los bordes de su elemento padre, utilice las propiedades « margins ».

Si fillWidth es false, el ancho del delegado viene determinado por su width.

Véase también « fillHeight » y « width ».

gradient : Gradient

El degradado de este delegado. El valor por defecto es null (sin degradado).

A diferencia de un «Quick Rectangle », en el que un degradado sustituye al color, StyleKit dibuja el degradado sobre el color. Esto significa que puedes utilizar un degradado semitransparente como superposición (por ejemplo, un sutil efecto de sombreado) mientras el color se ve a través de él.

button {
    background.gradient: Gradient {
        GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
        GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
    }
    background.color: "lightsteelblue"
    hovered.background.color: Qt.darker("lightsteelblue", 1.1)
    pressed.background.color: Qt.darker("lightsteelblue", 1.2)
}

Véase también « color ».

height : real

La altura de este delegado.

Nota: Esta propiedad solo establecerá la altura del delegado cuando fillHeight sea false. Esto también se aplica cuando fillHeight se establece en un nivel superior de la jerarquía de estilos, por ejemplo, en fallback style.

Si este delegado se encuentra en la raíz del control —por ejemplo, el ` background ` o el ` indicator `—, también se incluirá al calcular el ` implicit height ` del control, incluso cuando ` fillHeight ` sea ` true`.

Véase también « width» , « fillHeight », « minimumHeight » y «Resolución de propiedades de StyleKit».

image : ImageStyle

Propiedad agrupada para insertar una imagen dentro de este delegado.

Véase también ImageStyle.

leftMargin : real

El margen izquierdo de este delegado. Si no se especifica, se utiliza por defecto margins.

Véase también margins, rightMargin, topMargin y bottomMargin.

margins : real

El margen uniforme alrededor de este delegado. Al configurarlo, se establece un valor por defecto para leftMargin, rightMargin, topMargin y bottomMargin. Cada lado se puede anular de forma individual.

Véase también leftMargin, rightMargin, topMargin y bottomMargin.

minimumHeight : real

La altura mínima de este delegado. El delegado no tendrá un tamaño inferior a este valor.

minimumWidth : real

La anchura mínima de este delegado. El delegado no tendrá un tamaño inferior a este valor.

opacity : real

La opacidad de este delegado, desde 0.0 (totalmente transparente) hasta 1.0 (totalmente opaco). El valor por defecto es 1.0.

Véase también visible y color.

radius : real

El radio de esquina aplicado a las cuatro esquinas de este delegado. Las esquinas individuales se pueden anular con topLeftRadius, topRightRadius, bottomLeftRadius y bottomRightRadius.

Véase también topLeftRadius, topRightRadius, bottomLeftRadius y bottomRightRadius.

rightMargin : real

El margen derecho de este delegado. Si no se especifica, se utiliza por defecto margins.

Véase también margins, leftMargin, topMargin y bottomMargin.

rotation : real

La rotación de este delegado, en grados.

scale : real

El factor de escala de este delegado. El valor por defecto es 1.0.

shadow : ShadowStyle

Propiedad agrupada para aplicar una sombra proyectada detrás de este delegado.

Véase también ShadowStyle.

topLeftRadius : real

El radio de la esquina superior izquierda. Si no se especifica, se utiliza por defecto el valor « radius ».

Véase también radius, topRightRadius, bottomLeftRadius y bottomRightRadius.

topMargin : real

El margen superior de este delegado. Si no se especifica, se utiliza por defecto el valor de margins.

Véase también margins, bottomMargin, leftMargin y rightMargin.

topRightRadius : real

El radio de la esquina superior derecha. Si no se especifica, se utiliza por defecto el valor « radius ».

Véase también radius, topLeftRadius, bottomLeftRadius y bottomRightRadius.

visible : bool

Si este delegado es visible. El valor por defecto es true.

Nota: Aunque el valor predeterminado es « true », la propiedad « fallback style » (que anula muchos de los valores predeterminados) establece « background.visible » en « false » para los controles que, por lo general, no deben dibujar un fondo, como « CheckBox », « RadioButton » y « Slider ».

Cuando visible es false, no se creará el delegate. Si necesitas que se cree un delegado oculto, considera establecer opacity en 0 en su lugar.

Véase también opacity.

width : real

El ancho de este delegado.

Nota: Esta propiedad solo establecerá el ancho del delegado cuando fillWidth sea false. Esto también se aplica cuando fillWidth se establece en un nivel superior de la jerarquía de estilos, por ejemplo, en fallback style.

Si este delegado se encuentra en la raíz del control —por ejemplo, el background o el indicator —, también se incluirá al calcular el implicit width del control, incluso cuando fillWidth sea true.

Véase también height, fillWidth, minimumWidth y Resolución de propiedades de StyleKit.

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