Back to Qt.io
Contact Us Blog Download Qt
本页内容

QCanvasLinearGradient Class

QCanvasLinearGradient 是一款用于绘制线性渐变的画笔。更多内容...

标题： #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(qreal startX, qreal startY, qreal endX, qreal endY)
QCanvasLinearGradient(const QCanvasLinearGradient &)
QCanvasLinearGradient(QCanvasLinearGradient &&)
~QCanvasLinearGradient()
QPointF endPosition() const
void setEndPosition(qreal x, qreal y)
void setEndPosition(QPointF end)
void setStartPosition(qreal x, qreal y)
void setStartPosition(QPointF start)
QPointF startPosition() const
void swap(QCanvasLinearGradient &other)
QCanvasLinearGradient &operator=(QCanvasLinearGradient &&)
QCanvasLinearGradient &operator=(const QCanvasLinearGradient &)

详细说明

线性渐变会沿线性模式（即水平、垂直或对角线方向）在起始点和终点之间对颜色进行插值。渐变范围从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)。

QCanvasLinearGradient::QCanvasLinearGradient(QPointF start, QPointF end)

创建一个线性渐变。渐变起始颜色位置为start ，结束颜色位置为end 。

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

创建一个线性渐变。渐变起始颜色位置为 (startX,startY)，结束颜色位置为 (endX,endY)。

[constexpr noexcept default] QCanvasLinearGradient::QCanvasLinearGradient(const QCanvasLinearGradient &)

复制并构造一个QCanvasLinearGradient 实例。

[constexpr noexcept default] QCanvasLinearGradient::QCanvasLinearGradient(QCanvasLinearGradient &&)

通过Move构造一个QCanvasLinearGradient 的实例。

[constexpr noexcept default] QCanvasLinearGradient::~QCanvasLinearGradient()

销毁QCanvasLinearGradient 的实例。

QPointF QCanvasLinearGradient::endPosition() const

返回线性渐变的终点。

另请参阅 setEndPosition()。

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

将线性渐变的终点设置为 (x,y)。

另请参阅 endPosition()。

void QCanvasLinearGradient::setEndPosition(QPointF end)

将线性渐变的终点设置为end 。

这是一个重载函数。

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

将线性渐变的起始点设置为 (x,y)。

另请参阅 startPosition()。

void QCanvasLinearGradient::setStartPosition(QPointF start)

将线性渐变的起始点设置为start 。

这是一个重载函数。

QPointF QCanvasLinearGradient::startPosition() const

返回线性渐变的起始点。

另请参阅 setStartPosition()。

[noexcept] void QCanvasLinearGradient::swap(QCanvasLinearGradient &other)

将此渐变与other 互换。此操作速度极快，且绝不会失败。

[noexcept default] QCanvasLinearGradient &QCanvasLinearGradient::operator=(QCanvasLinearGradient &&)

将other 通过move赋值给此QCanvasLinearGradient 实例。

[noexcept default] QCanvasLinearGradient &QCanvasLinearGradient::operator=(const QCanvasLinearGradient &)

将other 复制并赋值给此QCanvasLinearGradient 实例。

© 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.