QGraphicsDropShadowEffect Class
QGraphicsDropShadowEffect 클래스는 드롭 섀도우 효과를 제공합니다. 더 보기...
| 헤더: | #include <QGraphicsDropShadowEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QGraphicsEffect |
속성
|
공개 함수
| QGraphicsDropShadowEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsDropShadowEffect() |
| qreal | blurRadius() const |
| QColor | color() const |
| QPointF | offset() const |
| qreal | xOffset() const |
| qreal | yOffset() const |
재구현된 공용 함수
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
공개 슬롯
| void | setBlurRadius(qreal blurRadius) |
| void | setColor(const QColor &color) |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
| void | setXOffset(qreal dx) |
| void | setYOffset(qreal dy) |
신호
| void | blurRadiusChanged(qreal blurRadius) |
| void | colorChanged(const QColor &color) |
| void | offsetChanged(const QPointF &offset) |
재구현된 보호 함수
| virtual void | draw(QPainter *painter) override |
상세 설명
드롭 섀도우 효과는 소스 객체에 드롭 섀도우를 적용합니다. 드롭 섀도우의 색상은 ` setColor()` 함수를 사용하여 수정할 수 있습니다. 드롭 섀도우의 오프셋은 ` setOffset()` 함수를 사용하여 수정할 수 있으며, 드롭 섀도우의 블러 반경은 ` setBlurRadius()` 함수를 사용하여 변경할 수 있습니다.
기본적으로 드롭 섀도우는 반투명한 짙은 회색(QColor(63, 63, 63, 180))의 그림자로, 반경 1로 블러 처리되어 오른쪽 아래 방향으로 8픽셀 오프셋되어 있습니다. 드롭 섀도우의 오프셋은 장치 좌표로 지정됩니다.
QGraphicsBlurEffect, QGraphicsColorizeEffect 및 QGraphicsOpacityEffect도 참조하십시오 .
속성 설명서
blurRadius : qreal
이 속성은 드롭 섀도우의 블러 반경(픽셀 단위)을 지정합니다.
반지름 값을 작게 설정하면 그림자가 더 선명해지고, 반대로 반지름 값을 크게 설정하면 그림자가 더 흐릿해집니다.
기본적으로 블러 반경은 1 픽셀입니다.
액세스 함수:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
알림 신호:
| void | blurRadiusChanged(qreal blurRadius) |
color : QColor
이 속성은 드롭 섀도우의 색상을 지정합니다.
기본적으로 드롭 섀도우 색상은 반투명한 짙은 회색(QColor(63, 63, 63, 180))입니다.
액세스 함수:
| QColor | color() const |
| void | setColor(const QColor &color) |
알림 신호:
| void | colorChanged(const QColor &color) |
offset() 및 blurRadius()도 참조하십시오 .
offset : QPointF
이 속성은 그림자 오프셋을 픽셀 단위로 저장합니다.
기본적으로 오프셋은 오른쪽 아래 방향으로 8픽셀입니다.
오프셋은 장치 좌표계로 지정되므로, 스케일링의 영향을 받지 않습니다.
액세스 함수:
| QPointF | offset() const |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
알림 신호:
| void | offsetChanged(const QPointF &offset) |
xOffset(), yOffset(), blurRadius(), color()도 참조하십시오 .
xOffset : qreal
이 속성은 수평 그림자 오프셋을 픽셀 단위로 저장합니다.
기본적으로 수평 그림자 오프셋은 8픽셀입니다.
액세스 함수:
| qreal | xOffset() const |
| void | setXOffset(qreal dx) |
알림 신호:
| void | offsetChanged(const QPointF &offset) |
yOffset() 및 offset()도 참조하십시오 .
yOffset : qreal
이 속성은 수직 그림자 오프셋을 픽셀 단위로 저장합니다.
기본적으로 수직 그림자 오프셋은 8 픽셀입니다.
액세스 함수:
| qreal | yOffset() const |
| void | setYOffset(qreal dy) |
알림 신호:
| void | offsetChanged(const QPointF &offset) |
멤버 함수 문서
QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)
새로운 QGraphicsDropShadowEffect 인스턴스를 생성합니다. ` parent ` 매개변수는 ` QGraphicsEffect`의 생성자에 전달됩니다.
[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()
효과를 해제합니다.
[signal] void QGraphicsDropShadowEffect::blurRadiusChanged(qreal blurRadius)
이 신호는 이펙트의 블러 반경이 변경될 때마다 발생합니다. ` blurRadius ` 매개변수에는 이펙트의 새로운 블러 반경이 저장됩니다.
참고: 속성 ` blurRadius`에 대한알림 신호입니다.
[override virtual] QRectF QGraphicsDropShadowEffect::boundingRectFor(const QRectF &rect) const
QGraphicsEffect::boundingRectFor(const QRectF &rect) const를 재구현합니다.
[signal] void QGraphicsDropShadowEffect::colorChanged(const QColor &color)
이 신호는 이펙트의 색상이 변경될 때마다 발생합니다. ` color ` 매개변수에는 이펙트의 새로운 색상이 저장됩니다.
참고: 속성 ` color`에 대한알림 신호입니다.
[override virtual protected] void QGraphicsDropShadowEffect::draw(QPainter *painter)
QGraphicsEffect::draw(QPainter *painter)를 재구현합니다.
[signal] void QGraphicsDropShadowEffect::offsetChanged(const QPointF &offset)
이 신호는 이펙트의 그림자 오프셋이 변경될 때마다 발생합니다. offset 매개변수에는 이펙트의 새로운 그림자 오프셋 값이 저장됩니다.
© 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.
