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: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- alignment : Qt::Alignment
- border : BorderStyle
- bottomLeftRadius : real
- bottomMargin : real
- bottomRightRadius : real
- clip : bool
- color : color
- data : QObject
- delegate : Component
- fillHeight : bool
- fillWidth : bool
- gradient : Gradient
- height : real
- image : ImageStyle
- leftMargin : real
- margins : real
- minimumHeight : real
- minimumWidth : real
- opacity : real
- radius : real
- rightMargin : real
- rotation : real
- scale : real
- shadow : ShadowStyle
- topLeftRadius : real
- topMargin : real
- topRightRadius : real
- visible : bool
- width : real
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 controldelegateStyle 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.