QGraphicsBlurEffect Class
Die Klasse „QGraphicsBlurEffect“ bietet einen Unschärfeeffekt. Mehr...
| Header: | #include <QGraphicsBlurEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QGraphicsEffect |
Öffentliche Typen
Eigenschaften
- blurHints : BlurHints
- blurRadius : qreal
Öffentliche Funktionen
| QGraphicsBlurEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsBlurEffect() |
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| qreal | blurRadius() const |
Neu implementierte ö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) |
Neu implementierte geschützte Funktionen
| virtual void | draw(QPainter *painter) override |
Ausführliche Beschreibung
Ein Unschärfeeffekt verwischt die Quelle. Dieser Effekt ist nützlich, um Details zu reduzieren, beispielsweise wenn die Quelle aus dem Fokus gerät und Sie die Aufmerksamkeit auf andere Elemente lenken möchten. Der Detaillierungsgrad kann mit der Funktion „ setBlurRadius()“ angepasst 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ätekordinaten angegeben.
Siehe auch „ QGraphicsDropShadowEffect “, „ QGraphicsColorizeEffect “ und „ QGraphicsOpacityEffect “.
Dokumentation zum Mitgliedstyp
enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints
Diese Enumeration beschreibt die möglichen Hinweise, mit denen gesteuert werden kann, wie Unschärfeeffekte angewendet werden. Die Hinweise haben möglicherweise nicht in allen Render-Engines eine Wirkung.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | Gibt an, dass die Rendering-Leistung der wichtigste Faktor ist, auch wenn dies möglicherweise zu Lasten der Qualität geht. |
QGraphicsBlurEffect::QualityHint | 0x01 | Gibt an, dass die Rendering-Qualität der wichtigste Faktor ist, was möglicherweise auf Kosten einer geringeren Leistung geht. |
QGraphicsBlurEffect::AnimationHint | 0x02 | Gibt an, dass der Unschärferadius animiert wird, was darauf hindeutet, dass die Implementierung einen Cache mit unscharfen Versionen der Quelle vorhalten kann. Verwenden Sie diesen Hinweis nicht, wenn sich die Quelle dynamisch ändert. |
Der Typ `BlurHints` ist ein `typedef` für ` QFlags<BlurHint>`. Er speichert eine OR-Kombination von `BlurHint`-Werten.
Siehe auch „ blurHints()“ und „ setBlurHints()“.
Dokumentation zur Eigenschaft
blurHints : BlurHints
Diese Eigenschaft enthält den Unschärfe-Hinweis des Effekts.
Verwenden Sie den Hinweis „ PerformanceHint “, um anzugeben, dass Sie eine schnellere Unschärfe wünschen, den Hinweis „ QualityHint “, um anzugeben, dass Sie eine höhere Unschärfequalität bevorzugen, oder den Hinweis „ AnimationHint “, wenn Sie den Unschärferadius animieren möchten.
Standardmäßig lautet der Unschärfe-Hinweis „ PerformanceHint “.
Zugriffsfunktionen:
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
Notifier-Signal:
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
blurRadius : qreal
Diese Eigenschaft legt den Unschärferadius des Effekts fest.
Ein kleinerer Radius führt zu einem schärferen Erscheinungsbild, während ein größerer Radius zu einem stärker unscharfen Erscheinungsbild führt.
Standardmäßig beträgt der Unschärferadius 5 Pixel.
Der Radius wird in Gerätekoodinaten angegeben, d. h., er wird von der Skalierung nicht beeinflusst.
Zugriffsfunktionen:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
Benachrichtigungssignal:
| void | blurRadiusChanged(qreal radius) |
Dokumentation der Mitgliedsfunktionen
QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)
Erstellt eine neue Instanz von `QGraphicsBlurEffect`. Der Parameter ` parent ` wird an den Konstruktor von ` QGraphicsEffect` übergeben.
[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()
Hebt den Effekt auf.
[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
Dieses Signal wird immer dann ausgelöst, wenn sich die Unschärfehinweise des Effekts ändern. Der Parameter „ hints “ enthält die neuen Unschärfehinweise des Effekts.
Hinweis: Notifier -Signal für die Eigenschaft „ blurHints “.
[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)
Dieses Signal wird immer dann ausgelöst, wenn sich der Unschärferadius des Effekts ändert. Der Parameter „ radius “ enthält den neuen Unschärferadius des Effekts.
Hinweis: Notifier -Signal für die Eigenschaft „ blurRadius “.
[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const
Implementiert: ` QGraphicsEffect::boundingRectFor` (const QRectF &rect) const.
[override virtual protected] void QGraphicsBlurEffect::draw(QPainter *painter)
Implementiert: ` QGraphicsEffect::draw(QPainter *painter)`.
© 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.
