QGradient Class

Descripción Detallada

Qt actualmente soporta tres tipos de rellenos de degradado:

• Los degradadoslineales interpolan colores entre puntos iniciales y finales.
• Los degradados radialessimples interpolan colores entre un punto focal y los puntos finales de un círculo que lo rodea.
• Los degradados radialesextendidos interpolan colores entre un centro y un círculo focal.
• Los degradadoscónicos interpolan colores alrededor de un punto central.

El tipo de un degradado puede recuperarse mediante la función type(). Cada tipo está representado por una subclase de QGradient:

QLinearGradient	QRadialGradient	QConicalGradient

Los colores de un gradiente se definen utilizando puntos de parada del tipo QGradientStop; es decir, una posición y un color. Utilice la función setColorAt() para definir un único punto de parada. Alternativamente, utilice la función setStops() para definir varios puntos de parada de una sola vez. Tenga en cuenta que esta última función sustituye al conjunto actual de puntos de parada.

Es el conjunto completo de puntos de parada del gradiente (accesible a través de la función stops()) el que describe cómo debe rellenarse el área del gradiente. Si no se han especificado puntos de parada, se utiliza un gradiente de negro a 0 a blanco a 1.

Un degradado lineal diagonal de negro a (100, 100) a blanco a (200, 200) podría especificarse 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 empezando 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 spread method mediante la función setSpread(). Por defecto se rellena el área exterior con el color del punto de parada más cercano. El valor actual de spread method puede recuperarse mediante la función spread(). El enum QGradient::Spread define tres métodos diferentes:

PadSpread	RepeatSpread	ReflectSpread

Tenga en cuenta que la función setSpread() sólo tiene efecto para gradientes lineales y radiales. La razón es que el gradiente cónico es cerrado por definición, es decir, el gradiente cónico llena todo el círculo de 0 - 360 grados, mientras que el límite de un gradiente radial o lineal puede especificarse a través de su radio o puntos finales de parada, respectivamente.

Las coordenadas del gradiente pueden especificarse en coordenadas lógicas, relativas a las coordenadas del dispositivo o relativas a las coordenadas del cuadro delimitador del objeto. La dirección coordinate mode puede establecerse mediante la función setCoordinateMode(). El valor por defecto es LogicalMode, donde las coordenadas del gradiente se especifican de la misma forma que las coordenadas del objeto. Para recuperar el valor actual de coordinate mode utilice coordinateMode().