QGraphicsDropShadowEffect Class
La clase QGraphicsDropShadowEffect proporciona un efecto de sombra proyectada. Más información...
| Encabezado: | #include <QGraphicsDropShadowEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QGraphicsEffect |
Propiedades
|
Funciones públicas
| QGraphicsDropShadowEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsDropShadowEffect() |
| qreal | blurRadius() const |
| QColor | color() const |
| QPointF | offset() const |
| qreal | xOffset() const |
| qreal | yOffset() const |
Funciones públicas reimplementadas
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
Ranuras públicas
| void | setBlurRadius(qreal blurRadius) |
| void | setColor(const QColor &color) |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
| void | setXOffset(qreal dx) |
| void | setYOffset(qreal dy) |
Señales
| void | blurRadiusChanged(qreal blurRadius) |
| void | colorChanged(const QColor &color) |
| void | offsetChanged(const QPointF &offset) |
Funciones protegidas reimplementadas
| virtual void | draw(QPainter *painter) override |
Descripción detallada
El efecto de sombra proyectada aplica una sombra proyectada al objeto de origen. El color de la sombra proyectada se puede modificar mediante la función ` setColor()`. El desplazamiento de la sombra proyectada se puede modificar mediante la función ` setOffset()`, y el radio de desenfoque de la sombra proyectada se puede cambiar con la función ` setBlurRadius()`.
Por defecto, la sombra proyectada es una sombra gris oscuro semitransparente (QColor(63, 63, 63, 180)), difuminada con un radio de 1 y un desplazamiento de 8 píxeles hacia la parte inferior derecha. El desplazamiento de la sombra proyectada se especifica en coordenadas del dispositivo.

Véase también QGraphicsBlurEffect, QGraphicsColorizeEffect y QGraphicsOpacityEffect.
Documentación de la propiedad
blurRadius : qreal
Esta propiedad establece el radio de desenfoque, en píxeles, de la sombra proyectada.
Si se utiliza un radio menor, la sombra resultará más nítida, mientras que si se utiliza un radio mayor, la sombra resultará más difuminada.
Por defecto, el radio de desenfoque es de 1 píxel.
Funciones de acceso:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
Señal de notificación:
| void | blurRadiusChanged(qreal blurRadius) |
Véase también color() y offset().
color : QColor
Esta propiedad determina el color de la sombra proyectada.
Por defecto, el color de la sombra es un gris oscuro semitransparente (QColor(63, 63, 63, 180)).
Funciones de acceso:
| QColor | color() const |
| void | setColor(const QColor &color) |
Señal de notificador:
| void | colorChanged(const QColor &color) |
Véase también offset() y blurRadius().
offset : QPointF
Esta propiedad almacena el desplazamiento de la sombra en píxeles.
Por defecto, el desplazamiento es de 8 píxeles hacia la esquina inferior derecha.
El desplazamiento se expresa en coordenadas del dispositivo, lo que significa que no se ve afectado por la escala.
Funciones de acceso:
| QPointF | offset() const |
| void | setOffset(const QPointF &ofs) |
| void | setOffset(qreal dx, qreal dy) |
| void | setOffset(qreal d) |
Señal de notificación:
| void | offsetChanged(const QPointF &offset) |
Véase también xOffset(), yOffset(), blurRadius() y color().
xOffset : qreal
Esta propiedad almacena el desplazamiento horizontal de la sombra en píxeles.
Por defecto, el desplazamiento horizontal de la sombra es de 8 píxeles.
Funciones de acceso:
| qreal | xOffset() const |
| void | setXOffset(qreal dx) |
Señal de notificación:
| void | offsetChanged(const QPointF &offset) |
Véase también yOffset() y offset().
yOffset : qreal
Esta propiedad establece el desplazamiento vertical de la sombra en píxeles.
Por defecto, el desplazamiento vertical de la sombra es de 8 píxeles.
Funciones de acceso:
| qreal | yOffset() const |
| void | setYOffset(qreal dy) |
Señal de notificación:
| void | offsetChanged(const QPointF &offset) |
Documentación de las funciones miembro
QGraphicsDropShadowEffect::QGraphicsDropShadowEffect(QObject *parent = nullptr)
Crea una nueva instancia de `QGraphicsDropShadowEffect`. El parámetro ` parent ` se pasa al constructor de ` QGraphicsEffect`.
[virtual noexcept] QGraphicsDropShadowEffect::~QGraphicsDropShadowEffect()
Anula el efecto.
[signal] void QGraphicsDropShadowEffect::blurRadiusChanged(qreal blurRadius)
Esta señal se emite cada vez que cambia el radio de desenfoque del efecto. El parámetro « blurRadius » contiene el nuevo radio de desenfoque del efecto.
Nota: Señalde notificación para la propiedad blurRadius.
[override virtual] QRectF QGraphicsDropShadowEffect::boundingRectFor(const QRectF &rect) const
Reimplementa: ` QGraphicsEffect::boundingRectFor` (const QRectF &rect) const.
[signal] void QGraphicsDropShadowEffect::colorChanged(const QColor &color)
Esta señal se emite cada vez que cambia el color del efecto. El parámetro « color » contiene el nuevo color del efecto.
Nota: Señalde notificación para la propiedad « color ».
[override virtual protected] void QGraphicsDropShadowEffect::draw(QPainter *painter)
Reimplementa: ` QGraphicsEffect::draw(QPainter *painter)`.
[signal] void QGraphicsDropShadowEffect::offsetChanged(const QPointF &offset)
Esta señal se emite cada vez que cambia el desplazamiento de la sombra del efecto. El parámetro « offset » contiene el nuevo desplazamiento de la sombra del efecto.
© 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.