QGradient Class
La clase QGradient se utiliza junto con QBrush para especificar rellenos degradados. Más información...
| Encabezado: | #include <QGradient> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- QGradient forma parte de las clases de pintura y de las clases compartidas implícitamente.
Tipos públicos
| enum | CoordinateMode { LogicalMode, ObjectMode, StretchToDeviceMode, ObjectBoundingMode } |
| enum | Preset { WarmFlame, NightFade, SpringWarmth, JuicyPeach, YoungPassion, …, PerfectBlue } |
| enum | Spread { PadSpread, RepeatSpread, ReflectSpread } |
| enum | Type { LinearGradient, RadialGradient, ConicalGradient, NoGradient } |
Funciones públicas
| QGradient(QGradient::Preset preset) | |
| QGradient::CoordinateMode | coordinateMode() const |
| void | setColorAt(qreal position, const QColor &color) |
| void | setCoordinateMode(QGradient::CoordinateMode mode) |
| void | setSpread(QGradient::Spread method) |
| void | setStops(const QGradientStops &stopPoints) |
| QGradient::Spread | spread() const |
| QGradientStops | stops() const |
| QGradient::Type | type() const |
| bool | operator!=(const QGradient &gradient) const |
| bool | operator==(const QGradient &gradient) const |
Elementos no miembros relacionados
Descripción detallada
Actualmente, Qt admite tres tipos de rellenos degradados:
- Los degradadoslineales interpolan los colores entre los puntos inicial y final.
- Los degradados radialessimples interpolan los colores entre un punto focal y los puntos finales situados en un círculo que lo rodea.
- Los degradados radialesextendidos interpolan los colores entre un centro y un círculo focal.
- Los degradadoscónicos interpolan los colores alrededor de un punto central.
El tipo de un degradado se puede obtener mediante la función ` type()`. Cada uno de los tipos está representado por una subclase de `QGradient`:
Los colores de un degradado se definen mediante puntos de parada del tipo ` QGradientStop `; es decir, una posición y un color. Utiliza la función ` setColorAt()` para definir un único punto de parada. Como alternativa, utiliza la función ` setStops()` para definir varios puntos de parada de una sola vez. Ten en cuenta que esta última función sustituye el conjunto actual de puntos de parada.
Es el conjunto completo de puntos de parada del degradado (al que se accede mediante la función stops()) el que describe cómo debe rellenarse el área del degradado. Si no se ha especificado ningún punto de parada, se utiliza un degradado que va del negro en 0 al blanco en 1.
Un degradado lineal diagonal que vaya del negro en (100, 100) al blanco en (200, 200) se podría especificar así:
QLinearGradient linearGrad(QPointF(100, 100), QPointF(200, 200));
linearGrad.setColorAt(0, Qt::black);
linearGrad.setColorAt(1, Qt::white);Un degradado puede tener un número arbitrario de puntos de parada. Lo siguiente crearía un degradado radial que comienza con rojo en el centro, azul y luego verde en los bordes:
QRadialGradient radialGrad(QPointF(100, 100), 100);
radialGrad.setColorAt(0, Qt::red);
radialGrad.setColorAt(0.5, Qt::blue);
radialGrad.setColorAt(1, Qt::green);Es posible repetir o reflejar el degradado fuera de su área especificando el « spread method » mediante la función ` setSpread()`. Por defecto, el área exterior se rellena con el color del punto de parada más cercano. El « spread method » establecido actualmente se puede recuperar mediante la función ` spread()`. La enumeración ` QGradient::Spread ` define tres métodos diferentes:
Ten en cuenta que la función setSpread() solo tiene efecto en los degradados lineales y radiales. El motivo es que el degradado cónico es cerrado por definición, es decir, el degradado cónico rellena todo el círculo de 0 a 360 grados, mientras que el límite de un degradado radial o lineal puede especificarse mediante su radio o sus puntos de parada finales, respectivamente.
Las coordenadas del degradado pueden especificarse en coordenadas lógicas, relativas a las coordenadas del dispositivo o relativas a las coordenadas del rectángulo delimitador del objeto. El « coordinate mode » puede establecerse mediante la función « setCoordinateMode()». El valor predeterminado es « LogicalMode », donde las coordenadas del degradado se especifican de la misma forma que las coordenadas del objeto. Para recuperar el « coordinate mode » establecido actualmente, utilice « coordinateMode()».
Véase también «El ejemplo de los gradientes » y « QBrush ».
Documentación sobre tipos de miembros
enum QGradient::CoordinateMode
Esta enumeración especifica cómo se asignan las coordenadas del degradado al dispositivo de pintura en el que se utiliza dicho degradado.
| Constante | Valor | Descripción |
|---|---|---|
QGradient::LogicalMode | 0 | Este es el modo predeterminado. Las coordenadas del degradado se especifican en el espacio lógico, al igual que las coordenadas del objeto. |
QGradient::ObjectMode | 3 | En este modo, las coordenadas del degradado son relativas al rectángulo delimitador del objeto que se está dibujando, con (0,0) en la esquina superior izquierda y (1,1) en la esquina inferior derecha del rectángulo delimitador del objeto. Este valor se añadió en Qt 5.12. |
QGradient::StretchToDeviceMode | 1 | En este modo, las coordenadas del degradado son relativas al rectángulo delimitador del dispositivo de dibujo, con (0,0) en la esquina superior izquierda y (1,1) en la esquina inferior derecha del mismo. |
QGradient::ObjectBoundingMode | 2 | Este modo es idéntico al ObjectMode, salvo que la transformación del pincel {QBrush::transform()} {brush transform}, si la hay, se aplica en relación con el espacio lógico en lugar de con el espacio del objeto. Este valor de enumeración está obsoleto y no debe utilizarse en código nuevo. |
enum QGradient::Preset
Esta enumeración especifica un conjunto de ajustes predefinidos para QGradient, basados en los degradados de https://webgradients.com/.
| Constante | Valor |
|---|---|
QGradient::WarmFlame | 1 |
QGradient::NightFade | 2 |
QGradient::SpringWarmth | 3 |
QGradient::JuicyPeach | 4 |
QGradient::YoungPassion | 5 |
QGradient::LadyLips | 6 |
QGradient::SunnyMorning | 7 |
QGradient::RainyAshville | 8 |
QGradient::FrozenDreams | 9 |
QGradient::WinterNeva | 10 |
QGradient::DustyGrass | 11 |
QGradient::TemptingAzure | 12 |
QGradient::HeavyRain | 13 |
QGradient::AmyCrisp | 14 |
QGradient::MeanFruit | 15 |
QGradient::DeepBlue | 16 |
QGradient::RipeMalinka | 17 |
QGradient::CloudyKnoxville | 18 |
QGradient::MalibuBeach | 19 |
QGradient::NewLife | 20 |
QGradient::TrueSunset | 21 |
QGradient::MorpheusDen | 22 |
QGradient::RareWind | 23 |
QGradient::NearMoon | 24 |
QGradient::WildApple | 25 |
QGradient::SaintPetersburg | 26 |
QGradient::PlumPlate | 28 |
QGradient::EverlastingSky | 29 |
QGradient::HappyFisher | 30 |
QGradient::Blessing | 31 |
QGradient::SharpeyeEagle | 32 |
QGradient::LadogaBottom | 33 |
QGradient::LemonGate | 34 |
QGradient::ItmeoBranding | 35 |
QGradient::ZeusMiracle | 36 |
QGradient::OldHat | 37 |
QGradient::StarWine | 38 |
QGradient::HappyAcid | 41 |
QGradient::AwesomePine | 42 |
QGradient::NewYork | 43 |
QGradient::ShyRainbow | 44 |
QGradient::MixedHopes | 46 |
QGradient::FlyHigh | 47 |
QGradient::StrongBliss | 48 |
QGradient::FreshMilk | 49 |
QGradient::SnowAgain | 50 |
QGradient::FebruaryInk | 51 |
QGradient::KindSteel | 52 |
QGradient::SoftGrass | 53 |
QGradient::GrownEarly | 54 |
QGradient::SharpBlues | 55 |
QGradient::ShadyWater | 56 |
QGradient::DirtyBeauty | 57 |
QGradient::GreatWhale | 58 |
QGradient::TeenNotebook | 59 |
QGradient::PoliteRumors | 60 |
QGradient::SweetPeriod | 61 |
QGradient::WideMatrix | 62 |
QGradient::SoftCherish | 63 |
QGradient::RedSalvation | 64 |
QGradient::BurningSpring | 65 |
QGradient::NightParty | 66 |
QGradient::SkyGlider | 67 |
QGradient::HeavenPeach | 68 |
QGradient::PurpleDivision | 69 |
QGradient::AquaSplash | 70 |
QGradient::SpikyNaga | 72 |
QGradient::LoveKiss | 73 |
QGradient::CleanMirror | 75 |
QGradient::PremiumDark | 76 |
QGradient::ColdEvening | 77 |
QGradient::CochitiLake | 78 |
QGradient::SummerGames | 79 |
QGradient::PassionateBed | 80 |
QGradient::MountainRock | 81 |
QGradient::DesertHump | 82 |
QGradient::JungleDay | 83 |
QGradient::PhoenixStart | 84 |
QGradient::OctoberSilence | 85 |
QGradient::FarawayRiver | 86 |
QGradient::AlchemistLab | 87 |
QGradient::OverSun | 88 |
QGradient::PremiumWhite | 89 |
QGradient::MarsParty | 90 |
QGradient::EternalConstance | 91 |
QGradient::JapanBlush | 92 |
QGradient::SmilingRain | 93 |
QGradient::CloudyApple | 94 |
QGradient::BigMango | 95 |
QGradient::HealthyWater | 96 |
QGradient::AmourAmour | 97 |
QGradient::RiskyConcrete | 98 |
QGradient::StrongStick | 99 |
QGradient::ViciousStance | 100 |
QGradient::PaloAlto | 101 |
QGradient::HappyMemories | 102 |
QGradient::MidnightBloom | 103 |
QGradient::Crystalline | 104 |
QGradient::PartyBliss | 106 |
QGradient::ConfidentCloud | 107 |
QGradient::LeCocktail | 108 |
QGradient::RiverCity | 109 |
QGradient::FrozenBerry | 110 |
QGradient::ChildCare | 112 |
QGradient::FlyingLemon | 113 |
QGradient::NewRetrowave | 114 |
QGradient::HiddenJaguar | 115 |
QGradient::AboveTheSky | 116 |
QGradient::Nega | 117 |
QGradient::DenseWater | 118 |
QGradient::Seashore | 120 |
QGradient::MarbleWall | 121 |
QGradient::CheerfulCaramel | 122 |
QGradient::NightSky | 123 |
QGradient::MagicLake | 124 |
QGradient::YoungGrass | 125 |
QGradient::ColorfulPeach | 126 |
QGradient::GentleCare | 127 |
QGradient::PlumBath | 128 |
QGradient::HappyUnicorn | 129 |
QGradient::AfricanField | 131 |
QGradient::SolidStone | 132 |
QGradient::OrangeJuice | 133 |
QGradient::GlassWater | 134 |
QGradient::NorthMiracle | 136 |
QGradient::FruitBlend | 137 |
QGradient::MillenniumPine | 138 |
QGradient::HighFlight | 139 |
QGradient::MoleHall | 140 |
QGradient::SpaceShift | 142 |
QGradient::ForestInei | 143 |
QGradient::RoyalGarden | 144 |
QGradient::RichMetal | 145 |
QGradient::JuicyCake | 146 |
QGradient::SmartIndigo | 147 |
QGradient::SandStrike | 148 |
QGradient::NorseBeauty | 149 |
QGradient::AquaGuidance | 150 |
QGradient::SunVeggie | 151 |
QGradient::SeaLord | 152 |
QGradient::BlackSea | 153 |
QGradient::GrassShampoo | 154 |
QGradient::LandingAircraft | 155 |
QGradient::WitchDance | 156 |
QGradient::SleeplessNight | 157 |
QGradient::AngelCare | 158 |
QGradient::CrystalRiver | 159 |
QGradient::SoftLipstick | 160 |
QGradient::SaltMountain | 161 |
QGradient::PerfectWhite | 162 |
QGradient::FreshOasis | 163 |
QGradient::StrictNovember | 164 |
QGradient::MorningSalad | 165 |
QGradient::DeepRelief | 166 |
QGradient::SeaStrike | 167 |
QGradient::NightCall | 168 |
QGradient::SupremeSky | 169 |
QGradient::LightBlue | 170 |
QGradient::MindCrawl | 171 |
QGradient::LilyMeadow | 172 |
QGradient::SugarLollipop | 173 |
QGradient::SweetDessert | 174 |
QGradient::MagicRay | 175 |
QGradient::TeenParty | 176 |
QGradient::FrozenHeat | 177 |
QGradient::GagarinView | 178 |
QGradient::FabledSunset | 179 |
QGradient::PerfectBlue | 180 |
enum QGradient::Spread
Especifica cómo se debe rellenar el área situada fuera de la zona del degradado.
| Constante | Valor | Descripción |
|---|---|---|
QGradient::PadSpread | 0 | El área se rellena con el color de parada más cercano. Esta es la opción predeterminada. |
QGradient::RepeatSpread | 2 | El degradado se repite fuera del área de degradado. |
QGradient::ReflectSpread | 1 | El degradado se refleja fuera del área de degradado. |
Véase también spread() y setSpread().
enum QGradient::Type
Especifica el tipo de degradado.
| Constante | Valor | Descripción |
|---|---|---|
QGradient::LinearGradient | 0 | Interpola los colores entre los puntos inicial y final (QLinearGradient). |
QGradient::RadialGradient | 1 | Interpola los colores entre un punto focal y los puntos finales de un círculo que lo rodea (QRadialGradient). |
QGradient::ConicalGradient | 2 | Interpola los colores alrededor de un punto central (QConicalGradient). |
QGradient::NoGradient | 3 | No se utiliza ningún degradado. |
Véase también type().
Documentación de funciones de miembro
QGradient::QGradient(QGradient::Preset preset)
Crea un degradado basado en un valor predefinido de « preset ».
El modo de coordenadas del degradado resultante es « QGradient::ObjectMode », lo que permite aplicar el preajuste a objetos de cualquier tamaño.
QGradient::CoordinateMode QGradient::coordinateMode() const
Devuelve el modo de coordenadas de este degradado. El modo predeterminado es « LogicalMode ».
Véase también setCoordinateMode().
void QGradient::setColorAt(qreal position, const QColor &color)
Crea un punto de parada en la posición position indicada con el ángulo color especificado. El valor position debe estar comprendido entre 0 y 1.
Véanse también setStops() y stops().
void QGradient::setCoordinateMode(QGradient::CoordinateMode mode)
Establece el modo de coordenadas de este degradado en « mode ». El modo predeterminado es « LogicalMode ».
Véase también coordinateMode().
void QGradient::setSpread(QGradient::Spread method)
Especifica el ancho method que debe utilizarse para este degradado.
Ten en cuenta que esta función solo surte efecto en los degradados lineales y radiales.
Véase también spread().
void QGradient::setStops(const QGradientStops &stopPoints)
Sustituye el conjunto actual de puntos de parada por el especificado en ` stopPoints`. Las posiciones de los puntos deben estar comprendidas entre 0 y 1, y deben estar ordenadas de menor a mayor.
Véanse también setColorAt() y stops().
QGradient::Spread QGradient::spread() const
Devuelve el método de propagación utilizado por este gradiente. El valor predeterminado es « PadSpread ».
Véase también setSpread().
QGradientStops QGradient::stops() const
Devuelve los puntos de parada de este degradado.
Si no se han especificado puntos de parada, se utiliza un degradado que va del negro (0) al blanco (1).
Véase también setStops() y setColorAt().
QGradient::Type QGradient::type() const
Devuelve el tipo de degradado.
bool QGradient::operator!=(const QGradient &gradient) const
Devuelve ` true ` si el gradiente es el mismo que el de los demás ` gradient ` especificados; en caso contrario, devuelve ` false`.
Véase también operator==().
bool QGradient::operator==(const QGradient &gradient) const
Devuelve ` true ` si el gradiente es el mismo que el de los demás ` gradient ` especificados; en caso contrario, devuelve ` false`.
Véase también operator!=().
Elementos no miembros relacionados
QGradientStop
Definición de tipo para std::pair<qreal, QColor>.
QGradientStops
Definición de tipo para QList<QGradientStop>.
© 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.





