En esta página

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.

Efecto de sombra proyectada en una imagen de un pez

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)

Véase también xOffset() y 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.

Nota: Señalde notificación para las propiedades « offset », « xOffset » y « yOffset ».

© 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.