이 페이지에서

QRadialGradient Class

QRadialGradient 클래스는 QBrush 와 함께 사용하여 방사형 그라데이션 브러시를 지정하는 데 사용됩니다. 더 보기...

헤더: #include <QRadialGradient>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
상속: QGradient

공개 함수

QRadialGradient()
QRadialGradient(const QPointF &center, qreal radius)
QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)
QRadialGradient(qreal cx, qreal cy, qreal radius)
QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)
QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)
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 ’ 메서드에 따라 그라디언트가 채워지거나, 반사되거나, 반복됩니다:

그라데이션의 색상은 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)

지정된 center, radius 및 원의 중심을 초점으로 하는 간단한 방사형 그라데이션을 생성합니다.

QGradient::setColorAt() 및 QGradient::setStops()도 참조하십시오 .

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)

(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 radius, qreal fx, qreal fy)

지정된 중심점(cx, cy), radius 및 초점(fx, fy)을 사용하여 간단한 방사형 그라데이션을 생성합니다.

참고: 지정된 초점이 중심(cx, cy)과 radius 으로 정의된 원의 바깥쪽에 있는경우 , 초점은 중심에서 초점으로 향하는 선과 원의 교차점으로 재조정됩니다.

QGradient::setColorAt() 및 QGradient::setStops()도 참조하십시오 .

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

지정된 중심 (cx, cy), 중심 반경 centerRadius, 초점 (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()도 참조하십시오 .

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