En esta página

QCanvasBoxGradient Class

QCanvasBoxGradient es un pincel para pintar degradados en cuadros. Más información...

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

Funciones públicas

QCanvasBoxGradient()
QCanvasBoxGradient(const QRectF &rect)
QCanvasBoxGradient(qreal x, qreal y, qreal width, qreal height)
QCanvasBoxGradient(const QCanvasBoxGradient &)
QCanvasBoxGradient(QCanvasBoxGradient &&)
~QCanvasBoxGradient()
qreal feather() const
qreal radius() const
QRectF rect() const
void setFeather(qreal feather)
void setRadius(qreal radius)
void setRect(qreal x, qreal y, qreal width, qreal height)
void setRect(const QRectF &rect)
void swap(QCanvasBoxGradient &other)
QCanvasBoxGradient &operator=(QCanvasBoxGradient &&)
QCanvasBoxGradient &operator=(const QCanvasBoxGradient &)

Descripción detallada

El degradado de cuadro interpola los colores entre los puntos inicial y final, creando un degradado con forma de rectángulo redondeado. Con las funciones « setRadius()» y « setFeather()» se puede controlar el redondez y la suavidad del degradado.

Cuatro cuadrados con degradados en forma de rectángulo redondeado, con distintos colores, radios de las esquinas y grados de suavidad en los bordes

A continuación se muestra un ejemplo sencillo:

Cuadrado redondeado de color azul oscuro con un suave resplandor amarillo en los bordes
QRectF rect(20, 20, 160, 160);
QCanvasBoxGradient bg(rect);
bg.setFeather(20);
bg.setRadius(50);
bg.setColorAt(0.0, "#1a2a6c");
bg.setColorAt(0.2, "#fdbb2d");
bg.setColorAt(1.0, QColorConstants::Transparent);
p->setFillStyle(bg);
p->fillRect(rect);

Nota: Cuando se utiliza QCanvasBoxGradient para dibujar un rectángulo redondeado, suele ser mejor emplear QCanvasPainter::rect() en lugar de QCanvasPainter::roundRect(), ya que el redondeo proviene del pincel y no de la ruta. De este modo se evita la creación de vértices adicionales y, por lo tanto, se obtiene un mejor rendimiento.

Documentación de las funciones de miembro

QCanvasBoxGradient::QCanvasBoxGradient()

Crea un degradado predeterminado para un cuadro. La posición del degradado es (0, 0) y el tamaño, (100, 100). El difuminado del degradado es de 10,0. El radio del degradado es de 0,0.

QCanvasBoxGradient::QCanvasBoxGradient(const QRectF &rect)

Crea un degradado en forma de cuadro. La posición y el tamaño del degradado son rect. El difuminado del degradado es de 10,0 y el radio es de 0,0.

Véase también setFeather() y setRadius().

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

Crea un degradado en forma de cuadro. La posición del degradado es ( x, y) y el tamaño ( width, height). El difuminado del degradado es de 10,0 y el radio es de 0,0.

Véanse también setFeather() y setRadius().

[constexpr noexcept default] QCanvasBoxGradient::QCanvasBoxGradient(const QCanvasBoxGradient &)

Crea una instancia de ` QCanvasBoxGradient` mediante copia.

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

Crea una instancia de ` QCanvasBoxGradient` mediante la construcción por movimiento.

[constexpr noexcept default] QCanvasBoxGradient::~QCanvasBoxGradient()

Elimina la instancia de « QCanvasBoxGradient ».

qreal QCanvasBoxGradient::feather() const

Devuelve el difuminado del degradado de la caja.

Véase también setFeather().

qreal QCanvasBoxGradient::radius() const

Devuelve el radio del degradado de caja.

Véase también setRadius().

QRectF QCanvasBoxGradient::rect() const

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

Véase también setRect().

void QCanvasBoxGradient::setFeather(qreal feather)

Establece el difuminado del degradado del cuadro en « feather ».

Véase también feather().

void QCanvasBoxGradient::setRadius(qreal radius)

Establece el radio del degradado del recuadro en radius. El radio máximo es la mitad del ancho o la altura de rect(), dependiendo de cuál de los dos sea menor.

Véase también radius().

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

Establece el rectángulo del degradado del recuadro en la posición ( x, y) y el tamaño ( width, height).

Véase también rect().

void QCanvasBoxGradient::setRect(const QRectF &rect)

Establece el rectángulo del degradado del cuadro en rect.

Esta es una función sobrecargada.

[noexcept] void QCanvasBoxGradient::swap(QCanvasBoxGradient &other)

Cambia este degradado por other. Esta operación es muy rápida y nunca falla.

[noexcept default] QCanvasBoxGradient &QCanvasBoxGradient::operator=(QCanvasBoxGradient &&)

Asigna other a esta instancia de QCanvasBoxGradient.

[noexcept default] QCanvasBoxGradient &QCanvasBoxGradient::operator=(const QCanvasBoxGradient &)

Asigna por copia other a esta instancia de QCanvasBoxGradient.

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