QRadialGradient 类

QRadialGradient 类与 QBrush 结合使用用于指定径向渐变画刷。更多...

头文件	#include <QRadialGradient>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui
继承	QGradient

所有成员列表，包括继承成员
QRadialGradient 是绘图类的一部分。

公共函数

	QRadialGradient()
	QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)
	QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)
	QRadialGradient(const QPointF &center, qreal radius)
	QRadialGradient(qreal cx, qreal cy, qreal radius)
	QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)
	QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)
QPointF	center() const
qreal	centerRadius() const
QPointF	focalPoint() const
qreal	focalRadius() const
qreal	radius() const
void	setCenter(const QPointF &center)
void	setCenter(qreal x, qreal y)
void	setCenterRadius(qreal radius)
void	setFocalPoint(const QPointF &focalPoint)
void	setFocalPoint(qreal x, qreal y)
void	setFocalRadius(qreal radius)
void	setRadius(qreal radius)

详细描述

Qt 支持简单和扩展径向渐变。

简单径向渐变在焦点和周围圆的末端点之间插值颜色。扩展径向渐变在焦点圆和中心圆之间插值颜色。两个圆定义的圆锥体之外的点将是透明的。对于简单径向渐变，焦点被调整以位于中心圆内，而扩展径向渐变中的焦点可以位于任何位置。

在末端点之外，渐变可能根据当前设置的 spread 方法填充、反射或重复


PadSpread（默认）	ReflectSpread	RepeatSpread

在渐变中使用QGradientStop类型的停止点来定义颜色，即位置和颜色。使用QGradient::setColorAt()或QGradient::setStops()函数来定义停止点。它描述了渐变色域该如何填充的完整停止点集合。如果没有指定停止点，则使用从0到1的黑到白色渐变。

除了从QGradient继承的函数外，QRadialGradient类还提供了返回渐变中心、焦点和半径的函数center()、focalPoint()和radius()。

另请参阅 QLinearGradient、QConicalGradient以及渐变示例。

成员函数文档

QRadialGradient::QRadialGradient()

构建一个以(0, 0)为中心和焦点的简单径向渐变，半径为1。

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)

构建一个简单径向渐变，它具有给定的center、radius和focalPoint。

注意：如果给定的焦点在由中心点center和半径radius定义的圆外，它将被重新调整到与从center到focalPoint的直线相交的圆上的点。

另请参阅 QGradient::setColorAt()和QGradient::setStops。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)

构建一个简单径向渐变，给定中心(cx, cy)、radius和焦点(fx, fy)。

注意：如果给定的焦点在中心(cx, cy)和半径radius定义的圆外，它将被重新调整到与从中心到焦点的线与圆的交点。

另请参阅 QGradient::setColorAt()和QGradient::setStops。

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius)

构建一个简单径向渐变，给定center、radius和焦点位于圆中心。

另请参阅 QGradient::setColorAt()和QGradient::setStops。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius)

构建一个简单径向渐变，中心在(cx, cy)，指定的radius。焦点位于圆中心。

另请参阅 QGradient::setColorAt()和QGradient::setStops。

QRadialGradient::QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)

使用给定的center、centerRadius、focalPoint和focalRadius构建扩展的径向渐变。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)

使用给定的中心(cx, cy)、中心半径、centerRadius、焦点focalPoint、(fx, fy)和焦点半径focalRadius构建扩展的径向渐变。

QPointF QRadialGradient::center() const

返回此径向渐变的逻辑坐标中的中心。

另请参阅setCenter()和QGradient::stops()。

qreal QRadialGradient::centerRadius() const

返回此径向渐变的逻辑坐标中的中心半径。

另请参阅setCenterRadius()和QGradient::stops()。

QPointF QRadialGradient::focalPoint() const

返回此径向渐变的逻辑坐标中的焦点。

另请参阅setFocalPoint()和QGradient::stops()。

qreal QRadialGradient::focalRadius() const

返回此径向渐变的逻辑坐标中的焦点半径。

另请参阅setFocalRadius()和QGradient::stops()。

qreal QRadialGradient::radius() const

返回此径向渐变的逻辑坐标中的半径。

相当于centerRadius()

另请参阅setRadius()和QGradient::stops()。

void QRadialGradient::setCenter(const QPointF &center)

将此径向渐变的逻辑坐标中的中心设置为center。

另请参阅center()。

void QRadialGradient::setCenter(qreal x, qreal y)

这是一个重载函数。

将此径向渐变的逻辑坐标中的中心设置为(x, y)。

另请参阅center()。

void QRadialGradient::setCenterRadius(qreal radius)

将此径向渐变的中心半径设置为逻辑坐标的radius

另请参阅 centerRadius().

void QRadialGradient::setFocalPoint(const QPointF &focalPoint)

将此径向渐变的焦点设置为逻辑坐标的focalPoint。

另请参阅 focalPoint().

void QRadialGradient::setFocalPoint(qreal x, qreal y)

这是一个重载函数。

将此径向渐变的焦点设置为逻辑坐标的(x, y)。

另请参阅 focalPoint().

void QRadialGradient::setFocalRadius(qreal radius)

将此径向渐变的焦点半径设置为逻辑坐标的radius

另请参阅 focalRadius().

void QRadialGradient::setRadius(qreal radius)

将此径向渐变的半径设置为逻辑坐标的radius

等价于 setCenterRadius()

另请参阅 radius().