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 &&)

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 를 이 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.