QGraphicsBlurEffect Class
QGraphicsBlurEffect クラスは、ぼかし効果を提供します。詳細...
| ヘッダー: | #include <QGraphicsBlurEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 継承元: | QGraphicsEffect |
パブリック型
プロパティ
- blurHints : BlurHints
- blurRadius : qreal
パブリック関数
| QGraphicsBlurEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsBlurEffect() |
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| qreal | blurRadius() const |
再実装されたパブリック関数
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
パブリックスロット
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
| void | setBlurRadius(qreal blurRadius) |
シグナル
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
| void | blurRadiusChanged(qreal radius) |
再実装されたプロテクト関数
| virtual void | draw(QPainter *painter) override |
詳細な説明
ぼかし効果は、ソースをぼかします。この効果は、ソースが焦点から外れ、他の要素に注目を集めたい場合など、細部を目立たなくするのに役立ちます。細部のレベルは、setBlurRadius() 関数を使用して変更できます。ぼかしのヒントを選択するには、setBlurHints() を使用します。
デフォルトでは、ぼかし半径は 5 ピクセルです。ぼかし半径はデバイス座標で指定されます。
QGraphicsDropShadowEffect 、QGraphicsColorizeEffect 、およびQGraphicsOpacityEffectも参照してください 。
メンバ型のドキュメント
enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints
この列挙型は、ぼかし効果の適用方法を制御するために使用できるヒントを定義しています。これらのヒントは、すべてのペイントエンジンで有効になるとは限りません。
| 定数 | 値 | 説明 |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | レンダリング性能が最も重要な要素であることを示します。その代償として、品質が低下する可能性があります。 |
QGraphicsBlurEffect::QualityHint | 0x01 | レンダリング品質を最優先とし、その代償としてパフォーマンスが低下する可能性があることを示します。 |
QGraphicsBlurEffect::AnimationHint | 0x02 | ぼかし半径がアニメーション化されることを示し、実装側でソースのぼかし処理済みバージョンのキャッシュを保持できることを示唆します。ソースが動的に変化する場合は、このヒントを使用しないでください。 |
BlurHints 型は、QFlags<BlurHint> の typedef です。これは、BlurHint 値の論理和（OR）を格納します。
blurHints() およびsetBlurHints()も参照してください 。
プロパティのドキュメント
blurHints : BlurHints
このプロパティは、エフェクトのぼかしヒントを保持します。
PerformanceHint ヒントを使用すると、より速いぼかしを指定できます。QualityHint ヒントを使用すると、より高品質なぼかしを指定できます。また、AnimationHint を使用すると、ぼかし半径をアニメーション化できます。
デフォルトでは、ぼかしヒントは `PerformanceHint` です。
アクセス関数：
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
Notifierシグナル：
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
blurRadius : qreal
このプロパティは、エフェクトのぼかし半径を指定します。
半径を小さくすると輪郭がくっきりとした見た目になり、半径を大きくするとぼやけた見た目になります。
デフォルトでは、ぼかし半径は 5 ピクセルです。
半径はデバイス座標で指定されるため、スケールの影響を受けません。
アクセス関数：
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
通知シグナル：
| void | blurRadiusChanged(qreal radius) |
メンバ関数のドキュメント
QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)
新しい QGraphicsBlurEffect インスタンスを作成します。parent パラメータは、QGraphicsEffect のコンストラクタに渡されます。
[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()
その効果を解除します。
[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
このシグナルは、エフェクトのぼかしヒントが変更されるたびに発火します。hints パラメータには、エフェクトの新しいぼかしヒントが格納されます。
注： プロパティ `blurHints` に対する通知 シグナルです。
[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)
このシグナルは、エフェクトのぼかし半径が変更されるたびに発火します。radius パラメータには、エフェクトの新しいぼかし半径が格納されます。
注： プロパティ `blurRadius` に対する通知 シグナルです。
[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const
QGraphicsEffect::boundingRectFor(const QRectF &rect) const を再実装します。
[override virtual protected] void QGraphicsBlurEffect::draw(QPainter *painter)
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.
