Sur cette page

QGraphicsBlurEffect Class

La classe QGraphicsBlurEffect fournit un effet de flou. Plus d'informations...

En-tête : #include <QGraphicsBlurEffect>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : QGraphicsEffect

Types publics

enum BlurHint { PerformanceHint, QualityHint, AnimationHint }
flags BlurHints

Propriétés

Fonctions publiques

QGraphicsBlurEffect(QObject *parent = nullptr)
virtual ~QGraphicsBlurEffect()
QGraphicsBlurEffect::BlurHints blurHints() const
qreal blurRadius() const

Fonctions publiques réimplémentées

virtual QRectF boundingRectFor(const QRectF &rect) const override

Emplacements publics

void setBlurHints(QGraphicsBlurEffect::BlurHints hints)
void setBlurRadius(qreal blurRadius)

Signaux

void blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
void blurRadiusChanged(qreal radius)

Fonctions protégées réimplémentées

virtual void draw(QPainter *painter) override

Description détaillée

Un effet de flou rend la source floue. Cet effet est utile pour réduire les détails, par exemple lorsque la source est floue et que vous souhaitez attirer l'attention sur d'autres éléments. Le niveau de détail peut être modifié à l'aide de la fonction setBlurRadius(). La fonction setBlurHints() permet de choisir les indices de flou.

Par défaut, le rayon de flou est de 5 pixels. Le rayon de flou est spécifié en coordonnées de périphérique.

Effet de flou sur l'image d'un poisson

Voir également QGraphicsDropShadowEffect, QGraphicsColorizeEffect, et QGraphicsOpacityEffect.

Documentation des types de membres

enum QGraphicsBlurEffect::BlurHint
drapeaux QGraphicsBlurEffect::BlurHints

Cette énumération décrit les indications possibles qui peuvent être utilisées pour contrôler la manière dont les effets de flou sont appliqués. Les indications peuvent ne pas avoir d'effet dans tous les moteurs de peinture.

ConstanteValeurDescription
QGraphicsBlurEffect::PerformanceHint0x00Indique que les performances de rendu sont le facteur le plus important, au prix d'une baisse potentielle de la qualité.
QGraphicsBlurEffect::QualityHint0x01Indique que la qualité du rendu est le facteur le plus important, au prix d'une baisse potentielle des performances.
QGraphicsBlurEffect::AnimationHint0x02Indique que le rayon de flou va être animé, ce qui laisse supposer que l'implémentation peut conserver un cache de versions floues de la source. N'utilisez pas cette indication si la source doit changer dynamiquement.

Le type BlurHints est un typedef pour QFlags<BlurHint>. Il stocke une combinaison OU de valeurs BlurHint.

Voir également blurHints() et setBlurHints().

Documentation sur les propriétés

blurHints : BlurHints

Cette propriété contient l'indice de flou de l'effet.

Utilisez l'indice PerformanceHint pour indiquer que vous souhaitez un flou plus rapide, l'indice QualityHint pour indiquer que vous préférez un flou de meilleure qualité, ou l'indice AnimationHint lorsque vous souhaitez animer le rayon du flou.

Par défaut, l'indice de flou est PerformanceHint.

Fonctions d'accès :

QGraphicsBlurEffect::BlurHints blurHints() const
void setBlurHints(QGraphicsBlurEffect::BlurHints hints)

Signal de notification :

void blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)

blurRadius : qreal

Cette propriété définit le rayon de flou de l'effet.

Un rayon plus petit donne un aspect plus net, tandis qu'un rayon plus grand donne un aspect plus flou.

Par défaut, le rayon de flou est de 5 pixels.

Le rayon est donné en coordonnées de périphérique, ce qui signifie qu'il n'est pas affecté par l'échelle.

Fonctions d'accès :

qreal blurRadius() const
void setBlurRadius(qreal blurRadius)

Signal Notificateur :

void blurRadiusChanged(qreal radius)

Fonction membre Documentation

QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)

Construit une nouvelle instance de QGraphicsBlurEffect. Le paramètre parent est transmis au constructeur de QGraphicsEffect.

[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()

Détruit l'effet.

[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)

Ce signal est émis lorsque les indications de flou de l'effet sont modifiées. Le paramètre hints contient les nouvelles indications de flou de l'effet.

Note : Signal de notification pour la propriété blurHints.

[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)

Ce signal est émis lorsque le rayon de flou de l'effet change. Le paramètre radius contient le nouveau rayon de flou de l'effet.

Remarque : signal de notification pour la propriété blurRadius.

[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const

Réimplémente : QGraphicsEffect::boundingRectFor(const QRectF &rect) const.

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

Réimplémente : 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.