En esta página

QBrush Class

La clase QBrush define el patrón de relleno de las figuras dibujadas por QPainter. Más información...

Encabezado: #include <QBrush>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

QBrush()
QBrush(Qt::BrushStyle style)
QBrush(const QGradient &gradient)
QBrush(const QImage &image)
QBrush(const QPixmap &pixmap)
QBrush(Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern)
QBrush(Qt::GlobalColor color, const QPixmap &pixmap)
QBrush(const QColor &color, Qt::BrushStyle style = Qt::SolidPattern)
QBrush(const QColor &color, const QPixmap &pixmap)
QBrush(const QBrush &other)
~QBrush()
const QColor &color() const
const QGradient *gradient() const
bool isOpaque() const
void setColor(const QColor &color)
void setColor(Qt::GlobalColor color)
void setStyle(Qt::BrushStyle style)
void setTexture(const QPixmap &pixmap)
void setTextureImage(const QImage &image)
void setTransform(const QTransform &matrix)
Qt::BrushStyle style() const
void swap(QBrush &other)
QPixmap texture() const
QImage textureImage() const
QTransform transform() const
operator QVariant() const
bool operator!=(const QBrush &brush) const
QBrush &operator=(QBrush &&other)
QBrush &operator=(const QBrush &brush)
(since 6.9) QBrush &operator=(QColor color)
(since 6.9) QBrush &operator=(Qt::BrushStyle style)
(since 6.9) QBrush &operator=(Qt::GlobalColor color)
bool operator==(const QBrush &brush) const
QDataStream &operator<<(QDataStream &stream, const QBrush &brush)
QDataStream &operator>>(QDataStream &stream, QBrush &brush)

Descripción detallada

Un pincel tiene un estilo, un color, un degradado y una textura.

El pincel style() define el patrón de relleno utilizando la enumeración Qt::BrushStyle. El estilo predeterminado del pincel es Qt::NoBrush (dependiendo de cómo se construya el pincel). Este estilo indica al pintor que no rellene las formas. El estilo estándar para el relleno es Qt::SolidPattern. El estilo se puede establecer al crear el pincel mediante el constructor adecuado y, además, la función setStyle() permite modificar el estilo una vez creado el pincel.

Estilos de pincel

El pincel color() define el color del patrón de relleno. El color puede ser uno de los colores predefinidos de Qt, Qt::GlobalColor, o cualquier otro color personalizado QColor. El color establecido actualmente se puede recuperar y modificar mediante las funciones color() y setColor(), respectivamente.

La función gradient() define el relleno degradado que se utiliza cuando el estilo actual es Qt::LinearGradientPattern, Qt::RadialGradientPattern o Qt::ConicalGradientPattern. Los pinceles degradados se crean pasando un QGradient como argumento del constructor al crear el QBrush. Qt proporciona tres degradados diferentes: QLinearGradient, QConicalGradient y QRadialGradient, todos los cuales heredan de QGradient.

    QRadialGradient gradient(50, 50, 50, 50, 50);
    gradient.setColorAt(0, QColor::fromRgbF(0, 1, 0, 1));
    gradient.setColorAt(1, QColor::fromRgbF(0, 0, 0, 0));

    QBrush brush(gradient);

La función ` texture()` define el mapa de píxeles que se utiliza cuando el estilo actual es ` Qt::TexturePattern`. Se puede crear un pincel con una textura proporcionando el mapa de píxeles al crear el pincel o utilizando ` setTexture()`.

Ten en cuenta que al aplicar ` setTexture()` se establece ` style()` == ` Qt::TexturePattern`, independientemente de la configuración de estilo anterior. Además, llamar a ` setColor()` no supondrá ninguna diferencia si el estilo es un degradado. Lo mismo ocurre si el estilo es ` Qt::TexturePattern `, a menos que la textura actual sea ` QBitmap`.

La función ` isOpaque()` devuelve ` true ` si el pincel es totalmente opaco; en caso contrario, devuelve `false`. Se considera que un pincel es opaco si:

  • El componente alfa de color() es 255.
  • Su texture() no tiene canal alfa y no es un QBitmap.
  • Todos los colores del gradient() tienen un componente alfa igual a 255.
Dos rectángulos superpuestos con contornosPara especificar el estilo y el color de las líneas y los contornos, utiliza el pen del QPainter combinado con Qt::PenStyle y Qt::GlobalColor:
QPainter painter(this);

painter.setBrush(Qt::cyan);
painter.setPen(Qt::darkCyan);
painter.drawRect(0, 0, 100,100);

painter.setBrush(Qt::NoBrush);
painter.setPen(Qt::darkGreen);
painter.drawRect(40, 40, 100, 100);

Ten en cuenta que, por defecto, QPainter dibuja el contorno (utilizando el lápiz actualmente seleccionado) al trazar figuras. Utiliza painter.setPen(Qt::NoPen) para desactivar este comportamiento.

Para obtener más información sobre el dibujo en general, consulta el Sistema de dibujo.

Véase también Qt::BrushStyle, QPainter y QColor.

Documentación de funciones de miembro

QBrush::QBrush()

Crea un pincel predeterminado de color negro con el estilo « Qt::NoBrush » (es decir, este pincel no rellenará las formas).

QBrush::QBrush(Qt::BrushStyle style)

Crea un pincel negro con el valor dado style.

Véase también setStyle().

QBrush::QBrush(const QGradient &gradient)

Crea un pincel basado en el estilo de degradado proporcionado gradient.

El estilo del pincel se establece en el estilo de degradado correspondiente (ya sea Qt::LinearGradientPattern, Qt::RadialGradientPattern o Qt::ConicalGradientPattern).

QBrush::QBrush(const QImage &image)

Crea un pincel de color negro y con una textura definida según el valor proporcionado en image. El estilo se establece en Qt::TexturePattern.

Véase también setTextureImage().

QBrush::QBrush(const QPixmap &pixmap)

Crea un pincel de color negro y con una textura definida según la dirección especificada en pixmap. El estilo se establece en Qt::TexturePattern.

Véase también setTexture().

QBrush::QBrush(Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern)

Crea un pincel con los valores indicados en « color » y « style ».

Véanse también setColor() y setStyle().

QBrush::QBrush(Qt::GlobalColor color, const QPixmap &pixmap)

Crea un pincel con el « color » indicado y el patrón personalizado almacenado en « pixmap ».

El estilo se establece en Qt::TexturePattern. El color solo tendrá efecto en los QBitmaps.

Véanse también setColor() y setTexture().

QBrush::QBrush(const QColor &color, Qt::BrushStyle style = Qt::SolidPattern)

Crea un pincel con los valores indicados en « color » y « style ».

Véase también setColor() y setStyle().

QBrush::QBrush(const QColor &color, const QPixmap &pixmap)

Crea un pincel con el ` color ` indicado y el patrón personalizado almacenado en ` pixmap`.

El estilo se establece en Qt::TexturePattern. El color solo tendrá efecto en los QBitmaps.

Véanse también setColor() y setTexture().

QBrush::QBrush(const QBrush &other)

Crea una copia de other.

[noexcept] QBrush::~QBrush()

Destruye el pincel.

const QColor &QBrush::color() const

Devuelve el color del pincel.

Véase también setColor().

const QGradient *QBrush::gradient() const

Devuelve el degradado que describe este pincel.

bool QBrush::isOpaque() const

Devuelve ` true ` si el pincel es totalmente opaco; en caso contrario, devuelve `false`. Se considera que un pincel es opaco si:

  • El componente alfa de la función ` color()` es 255.
  • Su ` texture()` no tiene canal alfa y no es una imagen ` QBitmap`.
  • Todos los colores del « gradient » () tienen un componente alfa igual a 255.
  • Se trata de un degradado radial extendido.

void QBrush::setColor(const QColor &color)

Establece el color del pincel en el valor indicado en ` color`.

Ten en cuenta que llamar a setColor() no tendrá ningún efecto si el estilo es un degradado. Lo mismo ocurre si el estilo es del tipo « Qt::TexturePattern », a menos que la textura actual sea del tipo « QBitmap ».

Véase también color().

void QBrush::setColor(Qt::GlobalColor color)

Establece el color del pincel en el valor indicado en color.

Esta es una función sobrecargada.

void QBrush::setStyle(Qt::BrushStyle style)

Establece el estilo del pincel en « style ».

Véase también style().

void QBrush::setTexture(const QPixmap &pixmap)

Establece el mapa de píxeles del pincel en pixmap. El estilo se establece en Qt::TexturePattern.

El color actual del pincel solo tendrá efecto en los mapas de píxeles monocromáticos, es decir, cuando QPixmap::depth() == 1 (QBitmaps).

Véase también texture().

void QBrush::setTextureImage(const QImage &image)

Establece la imagen del pincel en image. El estilo se establece en Qt::TexturePattern.

Ten en cuenta que el color actual del pincel no tendrá ningún efecto en las imágenes monocromáticas, a diferencia de lo que ocurre al llamar a setTexture() con un QBitmap. Si deseas cambiar el color de los pinceles de imágenes monocromáticas, convierte la imagen a QBitmap con QBitmap::fromImage() y establece el QBitmap resultante como textura, o bien modifica las entradas de la tabla de colores de la imagen.

Véase también textureImage() y setTexture().

void QBrush::setTransform(const QTransform &matrix)

Establece matrix como matriz de transformación explícita del pincel actual. La matriz de transformación del pincel se combina con la matriz de transformació QPainter e para obtener el resultado final.

Véase también transform().

Qt::BrushStyle QBrush::style() const

Devuelve el estilo del pincel.

Véase también setStyle().

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

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

QPixmap QBrush::texture() const

Devuelve el patrón de pincel personalizado o un mapa de píxeles nulo si no se ha establecido ningún patrón de pincel personalizado.

Véase también setTexture().

QImage QBrush::textureImage() const

Devuelve el patrón de pincel personalizado o una imagen nula si no se ha establecido ningún patrón de pincel personalizado.

Si la textura se ha establecido como un « QPixmap », se convertirá en un « QImage ».

Véase también setTextureImage().

QTransform QBrush::transform() const

Devuelve la matriz de transformación actual del pincel.

Véase también setTransform().

QBrush::operator QVariant() const

Devuelve el pincel como un QVariant

bool QBrush::operator!=(const QBrush &brush) const

Devuelve « true » si el pincel es diferente del especificado en « brush »; en caso contrario, devuelve « false ».

Dos pinceles son diferentes si tienen estilos, colores o transformaciones distintos, o si tienen mapas de píxeles o degradados diferentes, dependiendo del estilo.

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

[noexcept] QBrush &QBrush::operator=(QBrush &&other)

Asigna « other » a esta instancia de « QBrush ». ».

QBrush &QBrush::operator=(const QBrush &brush)

Asigna el ` brush ` indicado a este pincel y devuelve una referencia a este pincel.

[since 6.9] QBrush &QBrush::operator=(QColor color)

[since 6.9] QBrush &QBrush::operator=(Qt::GlobalColor color)

Convierte este pincel en un pincel de patrón sólido con el valor dado color y devuelve una referencia a este pincel.

Estas funciones se introdujeron en Qt 6.9.

[since 6.9] QBrush &QBrush::operator=(Qt::BrushStyle style)

Convierte este pincel en un pincel negro con el valor dado en « style » y devuelve una referencia a este pincel.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.9.

bool QBrush::operator==(const QBrush &brush) const

Devuelve « true » si el pincel es igual al especificado en « brush »; en caso contrario, devuelve « false ».

Dos pinceles son iguales si tienen los mismos estilos, colores y transformaciones, así como los mismos mapas de píxeles o degradados, dependiendo del estilo.

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

Elementos no miembros relacionados

QDataStream &operator<<(QDataStream &stream, const QBrush &brush)

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

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

QDataStream &operator>>(QDataStream &stream, QBrush &brush)

Lee el objeto ` brush ` 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.