Класс QGraphicsOpacityEffect

Класс QGraphicsOpacityEffect предоставляет эффект непрозрачности. Подробнее...

Заголовок:	#include <QGraphicsOpacityEffect>
CMake:	find_package(Qt6 COMPONENTS Widgets REQUIRED) 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.

`[signal]` void QGraphicsOpacityEffect::opacityChanged(qreal opacity)

Этот сигнал испускается всякий раз, когда непрозрачность эффекта изменяется. Параметр opacity содержит новую непрозрачность эффекта.

Примечание: Сигнал уведомления для свойства opacity.

`[signal]` void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)

Этот сигнал испускается всякий раз, когда маска непрозрачности эффекта изменяется. Параметр mask содержит новую маску непрозрачности эффекта.

Примечание: Сигнал уведомления для свойства opacityMask.

`[virtual]` QGraphicsOpacityEffect::~QGraphicsOpacityEffect()

Уничтожает эффект.

`[override virtual protected]` void QGraphicsOpacityEffect::draw(QPainter **painter*)

Переопределяет: QGraphicsEffect::draw(QPainter *painter).

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qgraphicsopacityeffect.html