QGraphicsBlurEffect Class
Die Klasse QGraphicsBlurEffect bietet einen Unschärfe-Effekt. Mehr...
| Kopfzeile: | #include <QGraphicsBlurEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QGraphicsEffect |
Öffentliche Typen
Eigenschaften
- blurHints : BlurHints
- blurRadius : qreal
Öffentliche Funktionen
| QGraphicsBlurEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsBlurEffect() |
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| qreal | blurRadius() const |
Reimplementierte öffentliche Funktionen
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
Öffentliche Slots
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
| void | setBlurRadius(qreal blurRadius) |
Signale
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
| void | blurRadiusChanged(qreal radius) |
Reimplementierte geschützte Funktionen
| virtual void | draw(QPainter *painter) override |
Detaillierte Beschreibung
Ein Blur-Effekt macht die Quelle unscharf. Dieser Effekt ist nützlich, um Details zu reduzieren, z. B. wenn die Quelle den Fokus verliert und Sie die Aufmerksamkeit auf andere Elemente lenken wollen. Der Detailgrad kann mit der Funktion setBlurRadius() geändert werden. Verwenden Sie setBlurHints(), um die Unschärfehinweise auszuwählen.
Standardmäßig beträgt der Unschärferadius 5 Pixel. Der Unschärferadius wird in Gerätekoordinaten angegeben.
Siehe auch QGraphicsDropShadowEffect, QGraphicsColorizeEffect, und QGraphicsOpacityEffect.
Dokumentation der Mitgliedstypen
enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints
Diese Aufzählung beschreibt die möglichen Hinweise, die verwendet werden können, um zu steuern, wie Unschärfeeffekte angewendet werden. Die Hinweise haben möglicherweise nicht in allen Paint-Engines eine Wirkung.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | Zeigt an, dass die Rendering-Leistung der wichtigste Faktor ist, möglicherweise auf Kosten einer geringeren Qualität. |
QGraphicsBlurEffect::QualityHint | 0x01 | Zeigt an, dass die Rendering-Qualität der wichtigste Faktor ist, möglicherweise auf Kosten einer geringeren Leistung. |
QGraphicsBlurEffect::AnimationHint | 0x02 | Zeigt an, dass der Unschärferadius animiert wird, was darauf hindeutet, dass die Implementierung einen Zwischenspeicher mit unscharfen Versionen der Quelle führen kann. Verwenden Sie diesen Hinweis nicht, wenn sich die Quelle dynamisch ändern soll. |
Der Typ BlurHints ist ein Typedef für QFlags<BlurHint>. Er speichert eine ODER-Kombination von BlurHint-Werten.
Siehe auch blurHints() und setBlurHints().
Dokumentation der Eigenschaft
blurHints : BlurHints
Diese Eigenschaft enthält den Weichzeichner-Hinweis des Effekts.
Verwenden Sie den Hinweis PerformanceHint, wenn Sie einen schnelleren Weichzeichner wünschen, den Hinweis QualityHint, wenn Sie eine höhere Qualität des Weichzeichners bevorzugen, oder AnimationHint, wenn Sie den Weichzeichnerradius animieren möchten.
Standardmäßig ist der Weichzeichner-Hinweis PerformanceHint.
Zugriffsfunktionen:
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
Benachrichtigungssignal:
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
blurRadius : qreal
Diese Eigenschaft bestimmt den Unschärferadius des Effekts.
Die Verwendung eines kleineren Radius führt zu einem schärferen Erscheinungsbild, während ein größerer Radius zu einem unschärferen Erscheinungsbild führt.
Standardmäßig beträgt der Unschärferadius 5 Pixel.
Der Radius wird in Gerätekoordinaten angegeben, was bedeutet, dass er von der Skalierung unbeeinflusst ist.
Zugriffsfunktionen:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
Benachrichtigungssignal:
| void | blurRadiusChanged(qreal radius) |
Member Function Dokumentation
QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)
Konstruiert eine neue QGraphicsBlurEffect-Instanz. Der Parameter parent wird an den Konstruktor von QGraphicsEffect übergeben.
[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()
Zerstört die Wirkung.
[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
Dieses Signal wird immer dann ausgegeben, wenn sich die Unschärfehinweise des Effekts ändern. Der Parameter hints enthält die neuen Unschärfehinweise des Effekts.
Hinweis: Benachrichtigungssignal für die Eigenschaft blurHints.
[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)
Dieses Signal wird ausgegeben, wenn sich der Unschärferadius des Effekts ändert. Der Parameter radius enthält den neuen Unschärferadius des Effekts.
Hinweis: Meldesignal für die Eigenschaft blurRadius.
[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const
Reimplements: QGraphicsEffect::boundingRectFor(const QRectF &rect) const.
[override virtual protected] void QGraphicsBlurEffect::draw(QPainter *painter)
Reimplements: QGraphicsEffect::draw(QPainter *Painter).
© 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.
