Sur cette page

QGraphicsBlurEffect Class

La classe QGraphicsBlurEffect permet d'appliquer un effet de flou. En savoir plus...

En-tête : #include <QGraphicsBlurEffect>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : 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

Slots 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 atténuer les détails, par exemple lorsque la source n'est plus au premier plan 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()`. Utilisez ` setBlurHints()` pour choisir les paramètres de flou.

Par défaut, le rayon de flou est de 5 pixels. Le rayon de flou est spécifié en coordonnées de l'appareil.

Effet de flou sur une image représentant un poisson

Voir également QGraphicsDropShadowEffect, QGraphicsColorizeEffect et QGraphicsOpacityEffect.

Documentation sur les types de membres

enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints

Cette énumération décrit les paramètres possibles permettant de contrôler la manière dont les effets de flou sont appliqués. Il se peut que ces paramètres n'aient pas d'effet dans tous les moteurs de rendu.

ConstanteValeurDescription
QGraphicsBlurEffect::PerformanceHint0x00Indique que les performances de rendu sont le facteur le plus important, au prix éventuel d’une qualité moindre.
QGraphicsBlurEffect::QualityHint0x01Indique que la qualité de rendu est le facteur le plus important, au prix éventuel d'une baisse des performances.
QGraphicsBlurEffect::AnimationHint0x02Indique que le rayon de flou va être animé, ce qui suggère que l’implémentation peut conserver en cache des versions floutées de la source. N’utilisez pas cette indication si la source est susceptible de changer de manière dynamique.

Le type `BlurHints` est une définition de type 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'indicateur de flou de l'effet.

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

Par défaut, l'indicateur 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 rendu plus net, tandis qu’un rayon plus grand donne un rendu plus flou.

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

Le rayon est exprimé en coordonnées de l'appareil, ce qui signifie qu'il n'est pas affecté par la mise à l'échelle.

Fonctions d'accès :

qreal blurRadius() const
void setBlurRadius(qreal blurRadius)

Signal de notification :

void blurRadiusChanged(qreal radius)

Documentation des fonctions membres

QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)

Crée une nouvelle instance de `QGraphicsBlurEffect`. Le paramètre ` parent ` est transmis au constructeur de ` QGraphicsEffect`.

[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()

Annule l'effet.

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

Ce signal est émis chaque fois que les indications de flou de l'effet changent. Le paramètre ` hints ` contient les nouvelles indications de flou de l'effet.

Remarque : signalde notification pour la propriété blurHints.

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

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

Remarque : signalde 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.