Home · All Classes · Modules

QLinearGradient Class Reference
^{[QtGui module]}

The QLinearGradient class is used in combination with QBrush to specify a linear gradient brush. More...

Inherits QGradient.

Methods

• __init__ (self)
• __init__ (self, QPointF start, QPointF finalStop)
• __init__ (self, float xStart, float yStart, float xFinalStop, float yFinalStop)
• __init__ (self, QLinearGradient)
• QPointF finalStop (self)
• setFinalStop (self, QPointF stop)
• setFinalStop (self, float x, float y)
• setStart (self, QPointF start)
• setStart (self, float x, float y)
• QPointF start (self)

The QLinearGradient class is used in combination with QBrush to specify a linear gradient brush.

Linear gradients interpolate colors between start and end points. Outside these points the gradient is either padded, reflected or repeated depending on the currently set spread method:

PadSpread (default)	ReflectSpread	RepeatSpread

The colors in a gradient is defined using stop points of the QGradientStop type, i.e. a position and a color. Use the QGradient.setColorAt() or the QGradient.setStops() function to define the stop points. It is the gradient's complete set of stop points that describes how the gradient area should be filled. If no stop points have been specified, a gradient of black at 0 to white at 1 is used.

In addition to the functions inherited from QGradient, the QLinearGradient class provides the finalStop() function which returns the final stop point of the gradient, and the start() function returning the start point of the gradient.

Method Documentation

QLinearGradient.__init__ (self)

Constructs a default linear gradient with interpolation area between (0, 0) and (1, 1).

See also QGradient.setColorAt(), setStart(), and setFinalStop().

QLinearGradient.__init__ (self, QPointF start, QPointF finalStop)

Constructs a linear gradient with interpolation area between the given start point and finalStop.

Note: The expected parameter values are in pixels.

See also QGradient.setColorAt() and QGradient.setStops().

QLinearGradient.__init__ (self, float xStart, float yStart, float xFinalStop, float yFinalStop)

Constructs a linear gradient with interpolation area between (x1, y1) and (x2, y2).

See also QGradient.setColorAt() and QGradient.setStops().

QLinearGradient.__init__ (self, QLinearGradient)

QPointF QLinearGradient.finalStop (self)

Returns the final stop point of this linear gradient in logical coordinates.

See also setFinalStop() and QGradient.stops().

QLinearGradient.setFinalStop (self, QPointF stop)

Sets the final stop point of this linear gradient in logical coordinates to stop.

This function was introduced in Qt 4.2.

See also finalStop().

QLinearGradient.setFinalStop (self, float x, float y)

This is an overloaded function.

See also start().

QLinearGradient.setStart (self, QPointF start)

Sets the start point of this linear gradient in logical coordinates to start.

This function was introduced in Qt 4.2.

See also start().

QLinearGradient.setStart (self, float x, float y)

This is an overloaded function.

See also start().

QPointF QLinearGradient.start (self)

Returns the start point of this linear gradient in logical coordinates.

See also setStart() and QGradient.stops().