QGraphicsOpacityEffect Class
QGraphicsOpacityEffect 클래스는 불투명도 효과를 제공합니다. 더 보기...
| 헤더: | #include <QGraphicsOpacityEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QGraphicsEffect |
속성
- opacity : qreal
- opacityMask : QBrush
공개 함수
| QGraphicsOpacityEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsOpacityEffect() |
| qreal | opacity() const |
| QBrush | opacityMask() const |
공개 슬롯
| void | setOpacity(qreal opacity) |
| void | setOpacityMask(const QBrush &mask) |
신호
| void | opacityChanged(qreal opacity) |
| void | opacityMaskChanged(const QBrush &mask) |
재구현된 보호 함수
| virtual void | draw(QPainter *painter) override |
상세 설명
불투명도 효과는 소스 객체를 불투명도로 렌더링합니다. 이 효과는 페이드 인/페이드 아웃 시퀀스와 유사하게 소스 객체를 반투명하게 만드는 데 유용합니다. 불투명도는 setOpacity() 함수를 사용하여 수정할 수 있습니다.
기본적으로 불투명도는 0.7입니다.
QGraphicsDropShadowEffect, QGraphicsBlurEffect 및 QGraphicsColorizeEffect도 참조하십시오 .
속성 설명서
opacity : qreal
이 속성은 효과의 불투명도를 나타냅니다.
값은 0.0에서 1.0 사이의 범위여야 하며, 0.0은 완전히 투명하고 1.0은 완전히 불투명함을 의미합니다.
기본적으로 불투명도는 0.7입니다.
액세스 함수:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
알림 신호:
| void | opacityChanged(qreal opacity) |
setOpacityMask()도 참조하십시오 .
opacityMask : QBrush
이 속성은 효과의 불투명도 마스크를 지정합니다.
불투명도 마스크를 사용하면 요소의 일부 영역에만 불투명도를 적용할 수 있습니다.
예를 들어:
//...
QLinearGradient alphaGradient(rect.topLeft(), rect.bottomLeft());
alphaGradient.setColorAt(0.0, Qt::transparent);
alphaGradient.setColorAt(0.5, Qt::black);
alphaGradient.setColorAt(1.0, Qt::transparent);
QGraphicsOpacityEffect *effect = new QGraphicsOpacityEffect;
effect->setOpacityMask(alphaGradient);
//...기본적으로 불투명도 마스크는 설정되어 있지 않습니다.
액세스 함수:
| QBrush | opacityMask() const |
| void | setOpacityMask(const QBrush &mask) |
알림 신호:
| void | opacityMaskChanged(const QBrush &mask) |
setOpacity()도 참조하십시오 .
멤버 함수 문서
QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)
새로운 QGraphicsOpacityEffect 인스턴스를 생성합니다. ` parent ` 매개변수는 ` QGraphicsEffect`의 생성자에 전달됩니다.
[virtual noexcept] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()
효과를 해제합니다.
[override virtual protected] void QGraphicsOpacityEffect::draw(QPainter *painter)
QGraphicsEffect::draw(QPainter *painter)를 재구현합니다.
[signal] void QGraphicsOpacityEffect::opacityChanged(qreal opacity)
이 신호는 이펙트의 불투명도가 변경될 때마다 발생합니다. ` opacity ` 매개변수에는 이펙트의 새로운 불투명도 값이 저장됩니다.
참고: ` opacity` 속성에 대한알림 신호입니다.
[signal] void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)
이 신호는 이펙트의 불투명도 마스크가 변경될 때마다 발생합니다. ` mask ` 매개변수에는 이펙트의 새로운 불투명도 마스크가 저장됩니다.
참고: 속성 opacityMask 에 대한알림 신호입니다.
© 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.
