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 |
- Lista de todos los miembros, incluidos los miembros heredados
- QBrush forma parte de las clases de pintura y de las clases compartidas implícitamente.
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 |
Elementos no miembros relacionados
| 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.

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.
![]() | Para 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:Ten en cuenta que, por defecto, QPainter dibuja el contorno (utilizando el lápiz actualmente seleccionado) al trazar figuras. Utiliza |
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.
