QBrush Class
La clase QBrush define el patrón de relleno de las formas dibujadas por QPainter. Más...
| Cabecera: | #include <QBrush> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluyendo los heredados
- QBrush es parte de Clases de Pintura y Clases Implícitamente Compartidas.
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 |
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 el enum Qt::BrushStyle. El estilo de pincel por defecto es Qt::NoBrush (dependiendo de cómo se construya el pincel). Este estilo le dice al pintor que no rellene las formas. El estilo estándar para rellenar es Qt::SolidPattern. El estilo puede establecerse cuando se crea el pincel utilizando el constructor apropiado, y además la función setStyle() proporciona medios para alterar el estilo una vez construido 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 personalizado QColor. El color actual puede recuperarse y modificarse mediante las funciones color() y setColor(), respectivamente.
La función gradient() define el relleno degradado utilizado cuando el estilo actual es Qt::LinearGradientPattern, Qt::RadialGradientPattern o Qt::ConicalGradientPattern. Los pinceles degradados se crean dando un QGradient como argumento constructor al crear el QBrush. Qt proporciona tres gradientes 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);
texture() define el pixmap usado cuando el estilo actual es Qt::TexturePattern. Puede crear un pincel con una textura proporcionando el pixmap cuando se crea el pincel o utilizando setTexture().
Tenga en cuenta que la aplicación de setTexture() hace que style() == Qt::TexturePattern, independientemente de los ajustes de estilo anteriores. 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, false. Un pincel se considera opaco si:
- El componente alfa de color() es 255.
- Su texture() no tiene canal alfa y no es un QBitmap.
- Todos los colores de gradient() tienen un componente alfa de 255.
Contornos | Para especificar el estilo y el color de las líneas y los contornos, utilice el QPainter's pen 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); Tenga en cuenta que, por defecto, QPainter representa el contorno (utilizando el lápiz configurado en ese momento) al dibujar formas. Utilice |
Para más información sobre el pintado en general, consulte el Sistema de pintado.
Véase también Qt::BrushStyle, QPainter, y QColor.
Documentación de las funciones miembro
QBrush::QBrush()
Crea un pincel negro predeterminado con el estilo Qt::NoBrush (es decir, este pincel no rellenará formas).
QBrush::QBrush(Qt::BrushStyle style)
Construye un pincel negro con la dirección style.
Véase también setStyle().
QBrush::QBrush(const QGradient &gradient)
Construye un pincel basado en la dirección 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 con un color negro y una textura definida en image. El estilo se establece en Qt::TexturePattern.
Véase también setTextureImage().
QBrush::QBrush(const QPixmap &pixmap)
Crea un pincel con un color negro y una textura definida en pixmap. El estilo se establece en Qt::TexturePattern.
Véase también setTexture().
QBrush::QBrush(Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern)
Construye un pincel con los datos color y style.
Véase también setColor() y setStyle().
QBrush::QBrush(Qt::GlobalColor color, const QPixmap &pixmap)
Construye un pincel con el color dado y el patrón personalizado almacenado en pixmap.
El estilo se establece en Qt::TexturePattern. El color sólo tendrá efecto para QBitmaps.
Véase también setColor() y setTexture().
QBrush::QBrush(const QColor &color, Qt::BrushStyle style = Qt::SolidPattern)
Construye un pincel con los datos color y style.
Véase también setColor() y setStyle().
QBrush::QBrush(const QColor &color, const QPixmap &pixmap)
Construye un pincel con el color dado y el patrón personalizado almacenado en pixmap.
El estilo se establece en Qt::TexturePattern. El color sólo tendrá efecto para QBitmaps.
Véase también setColor() y setTexture().
QBrush::QBrush(const QBrush &other)
Construye una copia de other.
[noexcept] QBrush::~QBrush()
Destruye el cepillo.
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 false. Un pincel se considera opaco si
- El componente alfa de color() es 255.
- Su texture() no tiene un canal alfa y no es un QBitmap.
- Todos los colores de gradient() tienen un componente alfa que es 255.
- Es un degradado radial extendido.
void QBrush::setColor(const QColor &color)
Establece el color del pincel en color.
Tenga en cuenta que llamar a setColor() no hará 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.
Ver también color().
void QBrush::setColor(Qt::GlobalColor color)
Establece el color del pincel 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 pixmap del pincel en pixmap. El estilo se establece en Qt::TexturePattern.
El color actual del pincel sólo tendrá efecto para pixmaps monocromos, es decir, para 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.
Tenga en cuenta que el color actual del pincel no afectará a las imágenes monocromas, al contrario que si llama a setTexture() con un QBitmap. Si desea cambiar el color de los pinceles de una imagen monocroma, convierta la imagen a QBitmap con QBitmap::fromImage() y establezca el QBitmap resultante como textura, o cambie 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 una matriz de transformación explícita en el pincel actual. La matriz de transformación del pincel se fusiona con la matriz de transformación de QPainter para producir 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 cepillo 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 pixmap nulo si no se ha establecido un 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 un patrón de pincel personalizado.
Si la textura se estableció como QPixmap se convertirá en 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 QVariant
bool QBrush::operator!=(const QBrush &brush) const
Devuelve true si el pincel es diferente del dado brush; en caso contrario devuelve false.
Dos pinceles son diferentes si tienen diferentes estilos, colores o transformaciones o diferentes pixmaps o gradientes dependiendo del estilo.
Véase también operator==().
[noexcept] QBrush &QBrush::operator=(QBrush &&other)
Mover-asigna other a esta instancia QBrush.
QBrush &QBrush::operator=(const QBrush &brush)
Asigna el brush dado 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 de la dirección 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 de la dirección 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 dado brush; en caso contrario devuelve false.
Dos pinceles son iguales si tienen estilos, colores y transformaciones iguales y pixmaps o degradados iguales dependiendo del estilo.
Véase también operator!=().
No miembros relacionados
QDataStream &operator<<(QDataStream &stream, const QBrush &brush)
Escribe el brush dado en el stream dado y devuelve una referencia al stream.
Véase también Serializar tipos de datos Qt.
QDataStream &operator>>(QDataStream &stream, QBrush &brush)
Lee el brush dado del stream dado y devuelve una referencia al stream.
Véase también Serializar tipos de datos 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.
Contornos