ConicalGradient QML Type
Dibuja un gradiente cónico. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- angle : real
- cached : bool
- gradient : Gradient
- horizontalOffset : real
- source : variant
- verticalOffset : real
Descripción detallada
Un degradado está definido por dos o más colores, que se mezclan a la perfección. Los colores comienzan en el ángulo especificado y terminan en un ángulo mayor de 360 grados.
| Efecto aplicado |
|---|
|
Ejemplo
El siguiente ejemplo muestra cómo aplicar el efecto.
import QtQuick import Qt5Compat.GraphicalEffects Item { width: 300 height: 300 ConicalGradient { anchors.fill: parent angle: 0.0 gradient: Gradient { GradientStop { position: 0.0; color: "white" } GradientStop { position: 1.0; color: "black" } } } }
Documentación de propiedades
angle : real
Esta propiedad define el ángulo inicial en el que se renderiza el color en la posición de gradiente de 0.0. Los colores en valores de posición mayores se renderizan en valores de ángulo mayores y se mezclan sin problemas. Los valores de ángulo aumentan en el sentido de las agujas del reloj.
| Ejemplos de salida con diferentes valores de ángulo | ||
|---|---|---|
|
|
|
| ángulo: 0 | ángulo 45 | ángulo: 185 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
cached : bool
Esta propiedad permite almacenar en caché los píxeles de salida del efecto para mejorar el rendimiento del renderizado.
Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.
Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.
Por defecto, la propiedad está establecida en false.
gradient : Gradient
Un degradado está definido por dos o más colores, que se mezclan a la perfección. Los colores se especifican como un conjunto de elementos hijos de GradientStop, cada uno de los cuales define una posición en el degradado (de 0,0 a 1,0), y un color. La posición de cada GradientStop se define mediante la propiedad position. El color se define mediante la propiedad color.
| Ejemplos de salida con diferentes valores de gradiente | ||
|---|---|---|
|
|
|
gradiente:Gradient {
GradientStop {
position: 0.000
color: Qt.rgba(1, 0, 0, 1)
}
GradientStop {
position: 0.167
color: Qt.rgba(1, 1, 0, 1)
}
GradientStop {
position: 0.333
color: Qt.rgba(0, 1, 0, 1)
}
GradientStop {
position: 0.500
color: Qt.rgba(0, 1, 1, 1)
}
GradientStop {
position: 0.667
color: Qt.rgba(0, 0, 1, 1)
}
GradientStop {
position: 0.833
color: Qt.rgba(1, 0, 1, 1)
}
GradientStop {
position: 1.000
color: Qt.rgba(1, 0, 0, 1)
}
} | gradiente:Gradient {
GradientStop {
position: 0.0
color: "#F0F0F0"
}
GradientStop {
position: 0.5
color: "#000000"
}
GradientStop {
position: 1.0
color: "#F0F0F0"
}
} | gradiente:Gradient {
GradientStop {
position: 0.0
color: "#00000000"
}
GradientStop {
position: 1.0
color: "#FF000000"
}
} |
| angle: 0 | angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
horizontalOffset : real
Las propiedades horizontalOffset y verticalOffset definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.
El valor oscila entre -inf e inf. Por defecto, las propiedades se establecen en 0.
| Ejemplos de salida con diferentes valores de horizontalOffset | ||
|---|---|---|
|
|
|
| horizontalOffset: -50 | horizontalOffset: 0 | horizontalOffset: 50 |
| angle: 0 | angle: 0 | angle: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
source : variant
Esta propiedad define el elemento que se va a rellenar con gradiente. El elemento fuente se renderiza en un búfer de píxeles intermedio y los valores alfa del resultado se utilizan para determinar la visibilidad de los píxeles del gradiente en la pantalla. El valor por defecto para la fuente es indefinido y en ese caso toda el área del efecto se rellena con degradado.
| Ejemplos de salida con diferentes valores de fuente | |
|---|---|
|
|
| fuente: indefinido | fuente: |
| angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 |
Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo estableciendo la fuente en el padre del efecto.
verticalOffset : real
Las propiedades horizontalOffset y verticalOffset definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.
El valor oscila entre -inf e inf. Por defecto, las propiedades se establecen en 0.
| Ejemplos de salida con diferentes valores de horizontalOffset | ||
|---|---|---|
|
|
|
| horizontalOffset: -50 | horizontalOffset: 0 | horizontalOffset: 50 |
| angle: 0 | angle: 0 | angle: 0 |
| verticalOffset: 0 | Desplazamiento vertical: 0 | Desplazamiento vertical: 0 |
© 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.











