QCanvasLinearGradient Class

QCanvasLinearGradient 是一种用于绘制线性渐变的画笔。更多

Header：	`#include <QCanvasLinearGradient>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)` `target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)`
自	Qt 6.11
继承于	QCanvasGradient
状态：	技术预览版

所有成员（包括继承成员）的列表

公共函数

	QCanvasLinearGradient()
	QCanvasLinearGradient(QPointF start, QPointF end)
	QCanvasLinearGradient(float startX, float startY, float endX, float endY)
QPointF	endPosition() const
void	setEndPosition(float x, float y)
void	setEndPosition(QPointF end)
void	setStartPosition(float x, float y)
void	setStartPosition(QPointF start)
QPointF	startPosition() const

详细说明

衬线渐变在起点和终点之间沿线性模式（水平、垂直或对角线）插入颜色。渐变开始于startPosition() ，结束于endPosition() 。在这一区域之外，颜色就是起点色和终点色。

下面是一个简单的示例：

QRectF rect1(0, 0, 200, 200);
QCanvasLinearGradient lg(rect1.topLeft(),
                    rect1.bottomRight());
lg.setColorAt(0.0, "#1a2a6c");
lg.setColorAt(0.5, "#b21f1f");
lg.setColorAt(1.0, "#fdbb2d");
p->setFillStyle(lg);
p->fillRect(rect1);

成员函数文档

QCanvasLinearGradient::QCanvasLinearGradient()

构建默认的线性渐变。渐变起始颜色位置为（0，0），结束颜色位置为（0，100）。渐变起始颜色为白色（255, 255, 255），结束颜色为透明黑色（0, 0, 0, 0）。

QCanvasLinearGradient::QCanvasLinearGradient(QPointF start, QPointF end)

构建线性渐变。渐变起始颜色位置为start ，终止颜色位置为end 。渐变起始颜色为白色（255, 255, 255），终止颜色为透明黑色（0, 0, 0, 0）。

QCanvasLinearGradient::QCanvasLinearGradient(float startX, float startY, float endX, float endY)

构建线性渐变。渐变起始颜色位置为 (startX,startY) ，结束颜色位置为 (endX,endY) 。渐变起始颜色为白色（255, 255, 255），终止颜色为透明黑色（0, 0, 0, 0）。

QPointF QCanvasLinearGradient::endPosition() const

返回线性梯度的终点。

另请参见 setEndPosition()。

void QCanvasLinearGradient::setEndPosition(float x, float y)

将线性梯度的终点设置为 (x,y)。

另请参见 endPosition().

void QCanvasLinearGradient::setEndPosition(QPointF end)

将线性梯度的终点设置为end 。

这是一个重载函数。

void QCanvasLinearGradient::setStartPosition(float x, float y)

将线性梯度的起点设置为 (x,y)。

另请参见 startPosition().

void QCanvasLinearGradient::setStartPosition(QPointF start)

将线性梯度的起点设置为start 。

这是一个重载函数。

QPointF QCanvasLinearGradient::startPosition() const

返回线性梯度的起点。

另请参见 setStartPosition()。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.