Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QGradient Class Reference
^{[QtGui module]}

该QGradient类是用来与组合QBrush指定渐变填充。More...

通过继承QConicalGradient，QLinearGradient和QRadialGradient。

Types

• enum CoordinateMode { LogicalMode, StretchToDeviceMode, ObjectBoundingMode }
• enum Spread { PadSpread, ReflectSpread, RepeatSpread }
• enum Type { LinearGradient, RadialGradient, ConicalGradient, NoGradient }

Methods

• __init__ (self)
• __init__ (self, QGradient)
• CoordinateMode coordinateMode (self)
• setColorAt (self, float pos, QColor color)
• setCoordinateMode (self, CoordinateMode mode)
• setSpread (self, Spread aspread)
• setStops (self, list-of-tuple-of-float-QColor stops)
• Spread spread (self)
• list-of-tuple-of-float-QColor stops (self)
• Type type (self)

Special Methods

• bool __eq__ (self, QGradient gradient)
• bool __ne__ (self, QGradient other)

Detailed Description

该QGradient类是用来与组合QBrush指定渐变填充。

目前的Qt支持三种类型的渐变填充的：

• Linear gradients interpolate colors between start and end points.
• Simple radial gradients interpolate colors between a focal point and end points on a circle surrounding it.
• Extended radial gradients interpolate colors between a center and a focal circle.
• Conical gradients interpolate colors around a center point.

渐变的类型可以使用被检索type（）函数。每个类型的被QGradient的子类表示：

QLinearGradient	QRadialGradient	QConicalGradient

在渐变中的颜色所使用的停止点定义QGradientStop型，即，位置和颜色。使用setColorAt（ ）函数来定义一个停止点。或者，使用setStops（ ）函数来一气呵成定义几个止损点。需要注意的是，后者的功能replaces当前设定的止损点。

它是渐变的一整套停止点（可通过stops（ ）函数） ，描述如何渐变区域应填补。如果已指定没有停止点，黑色在0到白在1梯度使用。

从黑对角线线性梯度（ 100 ， 100） ，以白色为（ 200 ， 200 ）可以这样指定：

     QLinearGradient linearGrad(QPointF(100, 100), QPointF(200, 200));
     linearGrad.setColorAt(0, Qt.black);
     linearGrad.setColorAt(1, Qt.white);

渐变可以有止损点的一个任意数字。下面将创建开始，红色在中心，蓝色和绿色，然后在边缘的径向渐变：

     QRadialGradient radialGrad(QPointF(100, 100), 100);
     radialGrad.setColorAt(0, Qt.red);
     radialGrad.setColorAt(0.5, Qt.blue);
     radialGrad.setColorAt(1, Qt.green);

它可以借由指定其区域之外的重复或反映该梯度的spread method使用setSpread（）函数。缺省值是垫在最近停止点的颜色外区域。当前设置spread method可使用检索到的spread（）函数。该QGradient.Spread枚举定义了三种不同的方法：

PadSpread	RepeatSpread	ReflectSpread

注意，这个setSpread（）函数只具有线性和径向渐变效果。其原因是，在锥形梯度通过定义封闭的，即conical渐变填充从0整个圆 - 360度，而径向或线性梯度的边界可以通过它的半径或最终停止点，分别被指定。

梯度坐标可以在逻辑坐标，相对于设备坐标，或者相对于对象的边界框的坐标来指定。该coordinate mode可使用设置setCoordinateMode（）函数。默认值是LogicalMode，其中所述梯度的坐标以相同的方式作为对象坐标指定。要检索当前设置的coordinate mode使用coordinateMode（ ） 。

Type Documentation

QGradient.CoordinateMode

此枚举指定如何渐变的坐标映射到其上的梯度可用于油漆设备。

这个枚举被引入或修改的Qt 4.4 。

QGradient.Spread

指定如何梯度范围之外的区域应该充满。

See also spread（）和setSpread（ ） 。

QGradient.Type

指定渐变的类型。

See also type（ ） 。

Method Documentation

QGradient.__init__ (self)

QGradient.__init__ (self, QGradient)

CoordinateMode QGradient.coordinateMode (self)

返回此渐变的坐标模式。默认模式是LogicalMode。

此功能被引入Qt的4.4 。

See also setCoordinateMode（ ） 。

QGradient.setColorAt (self, float pos, QColor color)

创建一个停止点在给定的position用给定的color。给定position必须是范围为0到1。

See also setStops（）和stops（ ） 。

QGradient.setCoordinateMode (self, CoordinateMode mode)

这个渐变的坐标模式设置为mode。默认模式是LogicalMode。

此功能被引入Qt的4.4 。

See also coordinateMode（ ） 。

QGradient.setSpread (self, Spread aspread)

指定的蔓延method应该用于该梯度。

注意，该函数只具有线性和径向渐变效果。

See also spread（ ） 。

QGradient.setStops (self, list-of-tuple-of-float-QColor stops)

替换当前设置的止损点与给定stopPoints。该点的位置必须在0到1范围，并与最低点首先必须进行排序。

See also setColorAt（）和stops（ ） 。

Spread QGradient.spread (self)

返回此梯度扩散方法的使用。默认值是PadSpread。

See also setSpread（ ） 。

list-of-tuple-of-float-QColor QGradient.stops (self)

返回止损点，这个梯度。

如果已指定没有停止点，黑色在0到白在1梯度使用。

See also setStops（）和setColorAt（ ） 。

Type QGradient.type (self)

返回渐变的类型。

bool QGradient.__eq__ (self, QGradient gradient)

bool QGradient.__ne__ (self, QGradient other)