En esta página

QCanvasBoxShadow Class

QCanvasBoxShadow es un pincel para pintar sombras y resplandores rectangulares. Más información...

Encabezado: #include <QCanvasBoxShadow>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Desde: Qt 6.11

Funciones públicas

QCanvasBoxShadow()
QCanvasBoxShadow(const QRectF &rect)
QCanvasBoxShadow(qreal x, qreal y, qreal width, qreal height)
QCanvasBoxShadow(QCanvasBoxShadow &&)
qreal blur() const
qreal bottomLeftRadius() const
qreal bottomRightRadius() const
QRectF boundingRect() const
QColor color() const
qreal radius() const
QRectF rect() const
void setBlur(qreal blur)
void setBottomLeftRadius(qreal radius)
void setBottomRightRadius(qreal radius)
void setColor(QColor color)
void setRadius(qreal radius)
void setRect(qreal x, qreal y, qreal width, qreal height)
void setRect(const QRectF &rect)
void setSpread(qreal spread)
void setTopLeftRadius(qreal radius)
void setTopRightRadius(qreal radius)
qreal spread() const
qreal topLeftRadius() const
qreal topRightRadius() const
bool operator!=(const QCanvasBoxShadow &lhs, const QCanvasBoxShadow &rhs)
QDataStream &operator<<(QDataStream &stream, const QCanvasBoxShadow &shadow)
bool operator==(const QCanvasBoxShadow &lhs, const QCanvasBoxShadow &rhs)
QDataStream &operator>>(QDataStream &stream, QCanvasBoxShadow &shadow)

Descripción detallada

QCanvasBoxShadow es un pincel de rectángulo redondeado con desenfoque aplicado. El rendimiento de QCanvasBoxShadow es mucho mejor que el de una sombra general que crea una sombra o resplandor difuminado en un elemento de cualquier forma, ya que utiliza el enfoque SDF.

Las características de QCanvasBoxShadow son similares a las de la sombra de cuadro (box-shadow) de CSS, con valores de radio, extensión, desenfoque y color. El resultado de la representación también coincide con la sombra de cuadro de CSS, con algunas diferencias notables para que QCanvasBoxShadow ofrezca el mayor rendimiento posible. El desenfoque se calcula matemáticamente en el sombreador, en lugar de utilizar el desenfoque gaussiano, que suelen emplear las implementaciones de «box-shadow» de CSS. Esto hace que la sombra tenga un aspecto ligeramente diferente, especialmente cuando la cantidad de desenfoque supera la mitad del ancho o la altura de la sombra.

A continuación se muestran capturas de pantalla para comparar el resultado de QCanvasBoxShadow y la propiedad «box-shadow» de CSS en el navegador Chrome. En ellas se aprecia cómo un radio de desenfoque de 0, 10, 20 y 40 píxeles afecta a las sombras más pequeñas.

Sombra de cuadro de CSS:

Filas formadas por una barra negra y un punto negro con un desenfoque de «box-shadow» en CSS de 0, 10, 20 y 40 píxeles

QCanvasBoxShadow:

Filas formadas por una barra negra y un punto negro con un desenfoque de QCanvasBoxShadow de 0, 10, 20 y 40 píxeles

Documentación de funciones de miembro

QCanvasBoxShadow::QCanvasBoxShadow()

Crea una sombra de cuadro predeterminada. La posición de la sombra de cuadro es (0, 0) y su tamaño (100, 100). El radio de las esquinas de la sombra es 0.0 y el desenfoque 0.0. El color de la sombra es Qt::black.

[explicit] QCanvasBoxShadow::QCanvasBoxShadow(const QRectF &rect)

Crea una sombra de caja negra con la posición rect, sin radio de esquina ni desenfoque.

QCanvasBoxShadow::QCanvasBoxShadow(qreal x, qreal y, qreal width, qreal height)

Crea una sombra de cuadro con la posición x, y y el tamaño width, height.

Véase también blur() y radius().

[constexpr noexcept default] QCanvasBoxShadow::QCanvasBoxShadow(QCanvasBoxShadow &&)

Crea mediante «move» una instancia de ` QCanvasBoxShadow`.

qreal QCanvasBoxShadow::blur() const

Devuelve el efecto de desenfoque del cuadro de sombra.

Véase también setBlur().

qreal QCanvasBoxShadow::bottomLeftRadius() const

Devuelve el radio de la esquina inferior izquierda del cuadro de sombra. Cuando este valor es -1, al dibujar la sombra se utilizará el valor de radius() para esta esquina. El valor por defecto es -1.

Véase también ` setBottomLeftRadius()`.

qreal QCanvasBoxShadow::bottomRightRadius() const

Devuelve el radio de la esquina inferior derecha del cuadro de sombra. Cuando este valor es -1, al dibujar la sombra se utilizará el valor de radius() para esta esquina. El valor por defecto es -1.

Véase también setBottomRightRadius().

QRectF QCanvasBoxShadow::boundingRect() const

Devuelve el área cubierta por la sombra. Para ello, tiene en cuenta las funciones rect(), blur() y spread(). Si no deseas utilizar el método auxiliar QCanvasPainter::drawBoxShadow(), puedes utilizar esto, por ejemplo, para añadir una QCanvasPainter::rect() del tamaño correcto a la ruta.

Véase también setRect(), setBlur() y setSpread().

QColor QCanvasBoxShadow::color() const

Devuelve el color del cuadro de sombra.

Véase también setColor().

qreal QCanvasBoxShadow::radius() const

Devuelve el radio de la caja de sombra.

Véase también ` setRadius()`.

QRectF QCanvasBoxShadow::rect() const

Devuelve el área del rectángulo de la caja de sombra.

Véase también setRect().

void QCanvasBoxShadow::setBlur(qreal blur)

Establece el desenfoque de la sombra en « blur » en píxeles. El valor por defecto es « 0.0 », lo que significa que no hay desenfoque.

Véase también blur().

void QCanvasBoxShadow::setBottomLeftRadius(qreal radius)

Establece el radio de la esquina inferior izquierda en radius. El valor por defecto es -1, lo que significa que no se ha establecido un radio específico para esta esquina y, en su lugar, se utiliza el radio común radius().

Véase también bottomLeftRadius().

void QCanvasBoxShadow::setBottomRightRadius(qreal radius)

Establece el radio de la esquina inferior derecha en radius. El valor por defecto es -1, lo que significa que no se ha establecido un radio específico para esta esquina y, en su lugar, se utiliza el radio común radius().

Véase también bottomRightRadius().

void QCanvasBoxShadow::setColor(QColor color)

Establece el color de la sombra en color. El valor por defecto es el negro con opacidad total.

Véase también color().

void QCanvasBoxShadow::setRadius(qreal radius)

Establece el radio de las esquinas de la sombra en radius en píxeles. El valor por defecto es 0.0, lo que significa que no hay radio.

Véase también radius().

void QCanvasBoxShadow::setRect(qreal x, qreal y, qreal width, qreal height)

Establece el área rectangular del «shadow box» en (x, y, width, height).

Véase también rect().

void QCanvasBoxShadow::setRect(const QRectF &rect)

Establece el área rectangular de la caja de sombra en rect.

Esta es una función sobrecargada.

void QCanvasBoxShadow::setSpread(qreal spread)

Establece la extensión de la sombra en « spread » en píxeles. El valor por defecto es « 0.0 », lo que significa que no hay extensión.

Véase también spread().

void QCanvasBoxShadow::setTopLeftRadius(qreal radius)

Establece el radio de la esquina superior izquierda en radius. El valor por defecto es -1, lo que significa que no se ha establecido un radio específico para esta esquina y, en su lugar, se utiliza el valor común radius().

Véase también topLeftRadius().

void QCanvasBoxShadow::setTopRightRadius(qreal radius)

Establece el radio de la esquina superior derecha en radius. El valor por defecto es -1, lo que significa que no se ha establecido un radio específico para esta esquina y, en su lugar, se utiliza el radio común radius().

Véase también topRightRadius().

qreal QCanvasBoxShadow::spread() const

Devuelve la extensión de la caja de sombra.

Véase también setSpread().

qreal QCanvasBoxShadow::topLeftRadius() const

Devuelve el radio de la esquina superior izquierda del cuadro de sombra. Cuando este valor es -1, al dibujar la sombra se utilizará el valor de radius() para esta esquina. El valor por defecto es -1.

Véase también setTopLeftRadius().

qreal QCanvasBoxShadow::topRightRadius() const

Devuelve el radio de la esquina superior derecha del cuadro de sombra. Cuando este valor es -1, al dibujar la sombra se utilizará el valor de radius() para esta esquina. El valor por defecto es -1.

Véase también setTopRightRadius().

Elementos relacionados no miembros

[noexcept] bool operator!=(const QCanvasBoxShadow &lhs, const QCanvasBoxShadow &rhs)

Devuelve ` true ` si la sombra de cuadro ` lhs ` es diferente de ` rhs`; en caso contrario, devuelve ` false `.

Véase también operator==().

QDataStream &operator<<(QDataStream &stream, const QCanvasBoxShadow &shadow)

Escribe el objeto ` shadow ` especificado en el objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.

Véase también «Serialización detipos de datos de Qt».

[noexcept] bool operator==(const QCanvasBoxShadow &lhs, const QCanvasBoxShadow &rhs)

Devuelve ` true ` si la sombra de la caja ` lhs ` es igual a ` rhs`; en caso contrario, devuelve ` false `.

Véase también operator!=().

QDataStream &operator>>(QDataStream &stream, QCanvasBoxShadow &shadow)

Lee el objeto ` shadow ` especificado a partir del objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.

Véase también «Serialización detipos de datos de Qt».

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