Table Of Contents

Previous topic

QRadialGradient

Next topic

QBrush

QLinearGradient

Synopsis

Functions

Detailed Description

The PySide.QtGui.QLinearGradient class is used in combination with PySide.QtGui.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:

../../_images/qlineargradient-pad.png ../../_images/qlineargradient-reflect.png ../../_images/qlineargradient-repeat.png
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 PySide.QtGui.QGradient , the PySide.QtGui.QLinearGradient class provides the PySide.QtGui.QLinearGradient.finalStop() function which returns the final stop point of the gradient, and the PySide.QtGui.QLinearGradient.start() function returning the start point of the gradient.

class PySide.QtGui.QLinearGradient
class PySide.QtGui.QLinearGradient(QLinearGradient)
class PySide.QtGui.QLinearGradient(start, finalStop)
class PySide.QtGui.QLinearGradient(xStart, yStart, xFinalStop, yFinalStop)
Parameters:

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

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

Note

The expected parameter values are in pixels.

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

Note

The expected parameter values are in pixels.

PySide.QtGui.QLinearGradient.finalStop()
Return type:PySide.QtCore.QPointF

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

PySide.QtGui.QLinearGradient.setFinalStop(stop)
Parameters:stopPySide.QtCore.QPointF

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

PySide.QtGui.QLinearGradient.setFinalStop(x, y)
Parameters:
  • xPySide.QtCore.qreal
  • yPySide.QtCore.qreal

This is an overloaded function.

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

PySide.QtGui.QLinearGradient.setStart(x, y)
Parameters:
  • xPySide.QtCore.qreal
  • yPySide.QtCore.qreal

This is an overloaded function.

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

PySide.QtGui.QLinearGradient.setStart(start)
Parameters:startPySide.QtCore.QPointF

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

PySide.QtGui.QLinearGradient.start()
Return type:PySide.QtCore.QPointF

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