QGraphicsOpacityEffect Class
Die Klasse QGraphicsOpacityEffect bietet einen Deckkraft-Effekt. Mehr...
| Kopfzeile: | #include <QGraphicsOpacityEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QGraphicsEffect |
Eigenschaften
- opacity : qreal
- opacityMask : QBrush
Öffentliche Funktionen
| QGraphicsOpacityEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsOpacityEffect() |
| qreal | opacity() const |
| QBrush | opacityMask() const |
Öffentliche Slots
| void | setOpacity(qreal opacity) |
| void | setOpacityMask(const QBrush &mask) |
Signale
| void | opacityChanged(qreal opacity) |
| void | opacityMaskChanged(const QBrush &mask) |
Reimplementierte geschützte Funktionen
| virtual void | draw(QPainter *painter) override |
Detaillierte Beschreibung
Ein Deckkraft-Effekt rendert die Quelle mit einer Deckkraft. Dieser Effekt ist nützlich, um die Quelle halbtransparent zu machen, ähnlich wie bei einer Ein-/Ausblendungssequenz. Die Deckkraft kann mit der Funktion setOpacity() geändert werden.
Standardmäßig ist die Deckkraft 0,7.
Siehe auch QGraphicsDropShadowEffect, QGraphicsBlurEffect, und QGraphicsColorizeEffect.
Dokumentation der Eigenschaft
opacity : qreal
Diese Eigenschaft gibt die Deckkraft des Effekts an.
Der Wert sollte im Bereich von 0,0 bis 1,0 liegen, wobei 0,0 für vollständig transparent und 1,0 für vollständig undurchsichtig steht.
Standardmäßig ist die Deckkraft 0,7.
Zugriffsfunktionen:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Benachrichtigungssignal:
| void | opacityChanged(qreal opacity) |
Siehe auch setOpacityMask().
opacityMask : QBrush
Diese Eigenschaft enthält die Deckkraftmaske des Effekts.
Mit einer Deckkraftmaske können Sie die Deckkraft auf Teile eines Elements anwenden.
Ein Beispiel:
... 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); ...
Standardmäßig ist keine Deckkraftmaske vorhanden.
Zugriffsfunktionen:
| QBrush | opacityMask() const |
| void | setOpacityMask(const QBrush &mask) |
Benachrichtigungssignal:
| void | opacityMaskChanged(const QBrush &mask) |
Siehe auch setOpacity().
Dokumentation der Mitgliedsfunktionen
QGraphicsOpacityEffect::QGraphicsOpacityEffect(QObject *parent = nullptr)
Konstruiert eine neue QGraphicsOpacityEffect-Instanz. Der Parameter parent wird an den Konstruktor von QGraphicsEffect übergeben.
[virtual noexcept] QGraphicsOpacityEffect::~QGraphicsOpacityEffect()
Zerstört die Wirkung.
[override virtual protected] void QGraphicsOpacityEffect::draw(QPainter *painter)
Reimplements: QGraphicsEffect::draw(QPainter *Painter).
[signal] void QGraphicsOpacityEffect::opacityChanged(qreal opacity)
Dieses Signal wird ausgegeben, wenn sich die Deckkraft des Effekts ändert. Der Parameter opacity enthält die neue Deckkraft des Effekts.
Hinweis: Meldesignal für die Eigenschaft opacity.
[signal] void QGraphicsOpacityEffect::opacityMaskChanged(const QBrush &mask)
Dieses Signal wird ausgegeben, wenn sich die Deckkraftmaske des Effekts ändert. Der Parameter mask enthält die neue Opazitätsmaske des Effekts.
Hinweis: Meldesignal für die Eigenschaft opacityMask.
© 2025 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.
