QGraphicsOpacityEffect 类

The QGraphicsOpacityEffect class provides an opacity effect. More...

头文件 #include <QGraphicsOpacityEffect>
CMakefind_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmakeQT += widgets
继承自 QGraphicsEffect

属性

公共函数

QGraphicsOpacityEffect(QObject *parent = nullptr)
虚函数~QGraphicsOpacityEffect()
qrealopacity() const
QBrushopacityMask() const

公共槽

voidsetOpacity(qreal opacity)
voidsetOpacityMask(const QBrush &mask)

信号

voidopacityChanged(qreal opacity)
voidopacityMaskChanged(const QBrush &mask)

重写的保护函数

虚拟函数draw(QPainter *painter) override

详细描述

不透明度效果会以不透明度渲染源。此效果可用于使源半透明，类似于淡入淡出序列。可以使用 setOpacity() 函数修改不透明度。

默认情况下，不透明度为 0.7。

另请参阅 QGraphicsDropShadowEffect，QGraphicsBlurEffect 和 QGraphicsColorizeEffect。

属性文档

opacity : qreal

此属性保存效果的透明度。

值应在 0.0 到 1.0 的范围内，其中 0.0 为完全透明，1.0 为完全不透明。

默认情况下，不透明度为 0.7。

访问函数

qrealopacity() const
voidsetOpacity(qreal opacity)

通知信号

voidopacityChanged(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);
...

默认情况下没有透明度遮罩。

访问函数

QBrushopacityMask() const
voidsetOpacityMask(const QBrush &mask)

通知信号

voidopacityMaskChanged(const QBrush &mask)

另请参阅 setOpacity().

成员函数说明

QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)

构建一个新的 QGraphicsOpacityEffect 实例。将 parent 参数传递给 QGraphicsEffect 构造函数。

[虚，无异常] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()

销毁效果。

[重写虚受保护的] void QGraphicsOpacityEffect::draw(QPainter *painter)

重新实现: QGraphicsEffect::draw(QPainter *painter).

[信号] void QGraphicsOpacityEffect::opacityChanged(qreal opacity)

每当效果的不透明度变化时都会发出此信号。参数 opacity 包含效果的新不透明度。

注意： 属性 opacity 的通知信号。

[信号] void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)

每当效果的不透明度遮罩变化时都会发出此信号。参数 mask 包含效果的新不透明度遮罩。

注意： 属性 opacityMask 的通知信号。

© 2024 Qt 公司 Ltd. 本文档贡献的版权属于各自的拥有者。本文档的提供受 GNU 自由文档许可协议版本 1.3 的条款约束，如由自由软件基金会发布。Qt 及相关标志是芬兰和/或世界其他国家的 Qt 公司的商标。所有其他商标均为各自所有者的财产。