En esta página

QRadialGradient Class

La clase QRadialGradient se utiliza en combinación con QBrush para especificar un pincel de gradiente radial. Más...

Cabecera: #include <QRadialGradient>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Hereda: QGradient

Funciones Públicas

QRadialGradient()
QRadialGradient(const QPointF &center, qreal radius)
QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)
QRadialGradient(qreal cx, qreal cy, qreal radius)
QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)
QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)
QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)
QPointF center() const
qreal centerRadius() const
QPointF focalPoint() const
qreal focalRadius() const
qreal radius() const
void setCenter(const QPointF &center)
void setCenter(qreal x, qreal y)
void setCenterRadius(qreal radius)
void setFocalPoint(const QPointF &focalPoint)
void setFocalPoint(qreal x, qreal y)
void setFocalRadius(qreal radius)
void setRadius(qreal radius)

Descripción Detallada

Qt soporta degradados radiales simples y extendidos.

Los degradados radiales simples interpolan colores entre un punto focal y los puntos finales de un círculo que lo rodea. Los degradados radiales extendidos interpolan colores entre un círculo focal y un círculo central. Los puntos situados fuera del cono definido por los dos círculos serán transparentes. En los degradados radiales simples, el punto focal se ajusta para que se encuentre dentro del círculo central, mientras que el punto focal puede tener cualquier posición en un degradado radial extendido.

Fuera de los puntos finales el gradiente se rellena, refleja o repite dependiendo del método spread actualmente establecido:

Los colores de un degradado se definen utilizando puntos finales del tipo QGradientStop, es decir, una posición y un color. Utilice la función QGradient::setColorAt() o QGradient::setStops() para definir los puntos de parada. Es el conjunto completo de puntos de parada del degradado el que describe cómo debe rellenarse el área del degradado. Si no se han especificado puntos de parada, se utiliza un degradado de negro a 0 a blanco a 1.

Además de las funciones heredadas de QGradient, la clase QRadialGradient proporciona las funciones center(), focalPoint() y radius() que devuelven el centro, el punto focal y el radio del gradiente respectivamente.

Ver también QLinearGradient, QConicalGradient, y El Ejemplo de Gradientes.

Documentación de las funciones miembro

QRadialGradient::QRadialGradient()

Construye un gradiente radial simple con el centro y punto focal en (0, 0) con un radio de 1.

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius)

Construye un gradiente radial simple con los valores center, radius y el punto focal en el centro del círculo.

Véase también QGradient::setColorAt() y QGradient::setStops().

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)

Construye un gradiente radial simple con los puntos center, radius y focalPoint.

Nota: Si el punto focal dado está fuera del círculo definido por el punto center y radius, se reajustará para situarse en un punto del círculo en el que se cruce con la línea que va de center a focalPoint.

Véase también QGradient::setColorAt() y QGradient::setStops().

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius)

Construye un gradiente radial simple con centro en (cx, cy) y el radius especificado. El punto focal se encuentra en el centro del círculo.

Véase también QGradient::setColorAt() y QGradient::setStops().

QRadialGradient::QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)

Construye un gradiente radial extendido con los datos center, centerRadius, focalPoint, y focalRadius.

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)

Construye un gradiente radial simple con el centro (cx, cy), radius y el punto focal (fx, fy) dados.

Nota: Si el punto focal dado está fuera del círculo definido por el centro (cx, cy) y el radius se reajustará a la intersección entre la línea desde el centro al punto focal y el círculo.

Véase también QGradient::setColorAt() y QGradient::setStops().

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)

Construye un gradiente radial extendido con el centro dado (cx, cy), radio central, centerRadius, punto focal, (fx, fy), y radio focal focalRadius.

QPointF QRadialGradient::center() const

Devuelve el centro de este gradiente radial en coordenadas lógicas.

Véase también setCenter() y QGradient::stops().

qreal QRadialGradient::centerRadius() const

Devuelve el radio central de este gradiente radial en coordenadas lógicas.

Véase también setCenterRadius() y QGradient::stops().

QPointF QRadialGradient::focalPoint() const

Devuelve el punto focal de este gradiente radial en coordenadas lógicas.

Véase también setFocalPoint() y QGradient::stops().

qreal QRadialGradient::focalRadius() const

Devuelve el radio focal de este gradiente radial en coordenadas lógicas.

Véase también setFocalRadius() y QGradient::stops().

qreal QRadialGradient::radius() const

Devuelve el radio de este gradiente radial en coordenadas lógicas.

Equivale a centerRadius()

Véase también setRadius() y QGradient::stops().

void QRadialGradient::setCenter(const QPointF &center)

Establece el centro de este gradiente radial en coordenadas lógicas en center.

Véase también center().

void QRadialGradient::setCenter(qreal x, qreal y)

Establece el centro de este gradiente radial en coordenadas lógicas a (x, y).

Esta es una función sobrecargada.

Ver también center().

void QRadialGradient::setCenterRadius(qreal radius)

Establece el radio central de este gradiente radial en coordenadas lógicas a radius

Véase también centerRadius().

void QRadialGradient::setFocalPoint(const QPointF &focalPoint)

Establece el punto focal de este gradiente radial en coordenadas lógicas en focalPoint.

Véase también focalPoint().

void QRadialGradient::setFocalPoint(qreal x, qreal y)

Establece el punto focal de este gradiente radial en coordenadas lógicas a (x, y).

Esta es una función sobrecargada.

Véase también focalPoint().

void QRadialGradient::setFocalRadius(qreal radius)

Establece el radio focal de este gradiente radial en coordenadas lógicas a radius

Véase también focalRadius().

void QRadialGradient::setRadius(qreal radius)

Establece el radio de este gradiente radial en coordenadas lógicas a radius

Equivale a setCenterRadius()

Véase también radius().

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