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 |
Elementos no miembros relacionados
| 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:

QCanvasBoxShadow:

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.