Класс QBrush

Класс QBrush определяет образец заполнения фигур, нарисованных с помощью QPainter. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Связанные внешние члены

Подробное описание

Класс QBrush определяет образец заполнения фигур, нарисованных с помощью QPainter.

Кисть имеет стиль, цвет, градиент и текстуру.

Стиль кисти style() определяет образец заполнения, используя перечисление Qt::BrushStyle. По умолчанию стиль кисти — Qt::NoBrush (зависит от способа создания кисти). Этот стиль сообщает рисовалке, что не нужно заполнять фигуры. Стандартный стиль заполнения — Qt::SolidPattern. Стиль можно установить при создании кисти, используя соответствующий конструктор, а также функция setStyle() предоставляет возможность изменения стиля после создания кисти.

Цвет кисти color() определяет цвет образца заполнения. Цвет может быть одним из предопределенных цветов Qt, Qt::GlobalColor, или любой другой пользовательской QColor. Текущий цвет можно получить и изменить с помощью функций color() и setColor() соответственно.

Градиент gradient() определяет градиентное заполнение, используемое, когда текущий стиль — Qt::LinearGradientPattern, Qt::RadialGradientPattern или Qt::ConicalGradientPattern. Кисти градиента создаются путем предоставления QGradient в качестве аргумента конструктора при создании QBrush. Qt предоставляет три разных градиента: QLinearGradient, QConicalGradient и QRadialGradient — все они наследуются от 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() определяет пиксель, используемый, когда текущий стиль — Qt::TexturePattern. Кисть с текстурой можно создать, указав пиксель при создании кисти или используя setTexture().

Обратите внимание, что применение setTexture() делает style() == Qt::TexturePattern, независимо от предыдущих настроек стиля. Также вызов setColor() не повлияет на результат, если стиль — градиент. То же самое относится к стилю Qt::TexturePattern, за исключением случая, когда текущая текстура — QBitmap.

Функция isOpaque() возвращает true , если кисть полностью непрозрачна, в противном случае — ложь. Кисть считается непрозрачной, если:

• Компонент альфа текущего color() равен 255.
• У её texture() нет канала альфа и она не является QBitmap.
• Все цвета в gradient() имеют компонент альфа, равный 255.

Для задания стиля и цвета линий и контуров используйте QPainter's pen в сочетании с Qt::PenStyle и 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); Обратите внимание, что по умолчанию QPainter отрисовывает контур (с использованием текущего пера) при рисовании фигур. Используйте painter.setPen(Qt::NoPen), чтобы отключить это поведение.

Для получения дополнительной информации о рисовании в целом см. Система рисования.

См. также Qt::BrushStyle, QPainter и QColor.

Документация функций-членов

QBrush::QBrush()

Конструирует кисть по умолчанию черного цвета со стилем Qt::NoBrush (т.е. эта кисть не будет заполнять фигуры).

QBrush::QBrush(Qt::BrushStyle style)

Конструирует черную кисть с указанным style.

См. также setStyle().

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

Создаёт кисть с заданным цветом color и стилем style.

См. также setColor() и setStyle().

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

Создаёт кисть с заданным цветом color и стилем style.

См. также setColor() и setStyle().

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

Создаёт кисть с заданным цветом color и пользовательским узором, хранящимся в pixmap.

Стиль устанавливается в Qt::TexturePattern. Цвет будет иметь значение только для QBitmaps.

См. также setColor() и setTexture().

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

Создаёт кисть с заданным цветом color и пользовательским узором, хранящимся в pixmap.

Стиль устанавливается в Qt::TexturePattern. Цвет будет иметь значение только для QBitmaps.

См. также setColor() и setTexture().

QBrush::QBrush(const QPixmap &pixmap)

Создаёт кисть с чёрным цветом и текстурой, заданной pixmap. Стиль устанавливается в Qt::TexturePattern.

См. также setTexture().

QBrush::QBrush(const QImage &image)

Создаёт кисть с чёрным цветом и текстурой, заданной image. Стиль устанавливается в Qt::TexturePattern.

См. также setTextureImage().

QBrush::QBrush(const QBrush &other)

Создаёт копию other.

QBrush::QBrush(const QGradient &gradient)

Создаёт кисть на основе заданного gradient.

Стиль кисти устанавливается в соответствующий стиль градиента (либо Qt::LinearGradientPattern, Qt::RadialGradientPattern или Qt::ConicalGradientPattern).

QBrush::~QBrush()

Удаляет кисть.

const QColor &QBrush::color() const

Возвращает цвет кисти.

См. также setColor().

const QGradient *QBrush::gradient() const

Возвращает градиент, описывающий эту кисть.

bool QBrush::isOpaque() const

Возвращает true , если кисть полностью непрозрачна, в противном случае false. Кисть считается непрозрачной, если:

• Компонент альфа цвета color() равен 255.
• Её texture() не имеет канала альфа и не является QBitmap.
• Цвета в gradient() имеют компонент альфа, равный 255.
• Это расширенный радиальный градиент.

const QMatrix &QBrush::matrix() const

Возвращает текущую матрицу преобразования для кисти.

Эта функция была добавлена в Qt 4.2.

См. также setMatrix().

void QBrush::setColor(const QColor &color)

Устанавливает цвет кисти на заданный цвет color.

Обратите внимание, что вызов setColor() не повлияет на стиль, если стиль является градиентом. То же самое происходит, если стиль имеет Qt::TexturePattern стиль, за исключением случая, если текущая текстура — QBitmap.

См. также color().

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

Это перегруженная функция.

Устанавливает цвет кисти на заданный цвет color.

void QBrush::setMatrix(const QMatrix &matrix)

Устанавливает matrix как явную матрицу преобразования для текущей кисти. Матрица преобразования кисти объединяется с матрицей преобразования QPainter для получения конечного результата.

Эта функция была добавлена в Qt 4.2.

См. также matrix().

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

Устанавливает стиль кисти на style.

См. также style().

void QBrush::setTexture(const QPixmap &pixmap)

Устанавливает пиксель кисти на pixmap. Стиль устанавливается в Qt::TexturePattern.

Текущий цвет кисти будет иметь значение только для монохромных пиксельных изображений, т.е. для QPixmap::depth() == 1 (QBitmaps).

См. также texture().

void QBrush::setTextureImage(const QImage &image)

Устанавливает изображение кисти на image. Стиль устанавливается в Qt::TexturePattern.

Обратите внимание, что текущий цвет кисти не повлияет на монохромные изображения, в отличие от вызова setTexture() с QBitmap. Если вы хотите изменить цвет монохромных кистей с изображением, либо преобразуйте изображение в QBitmap с помощью QBitmap::fromImage() и установите полученную QBitmap в качестве текстуры, либо измените записи в таблице цветов для изображения.

Эта функция была добавлена в Qt 4.2.

См. также textureImage() и setTexture().

void QBrush::setTransform(const QTransform &matrix)

Устанавливает matrix как явную матрицу преобразования для текущей кисти. Матрица преобразования кисти объединяется с матрицей преобразования QPainter для получения конечного результата.

Эта функция была добавлена в Qt 4.3.

См. также transform().

Qt::BrushStyle QBrush::style() const

Возвращает стиль кисти.

См. также setStyle().

void QBrush::swap(QBrush &other)

Меняет местами кисть other с этой кистью. Эта операция очень быстрая и никогда не терпит неудачу.

Эта функция была добавлена в Qt 4.8.

QPixmap QBrush::texture() const

Возвращает пользовательский узор кисти или пустое изображение, если пользовательский узор кисти не был установлен.

См. также setTexture().

QImage QBrush::textureImage() const

Возвращает пользовательский узор кисти или пустое изображение, если пользовательский узор кисти не был установлен.

Если текстура была установлена как QPixmap, она будет преобразована в QImage.

Эта функция была добавлена в Qt 4.2.

См. также setTextureImage().

QTransform QBrush::transform() const

Возвращает текущую матрицу преобразования для кисти.

Эта функция была добавлена в Qt 4.3.

См. также setTransform().

QBrush::operator QVariant() const

Возвращает кисть как QVariant

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

Возвращает true если кисть отличается от заданной brush; в противном случае возвращает false.

Две кисти различаются, если у них разные стили, цвета или преобразования, или разные пиксельные изображения или градиенты в зависимости от стиля.

См. также operator==().

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

Присваивает заданную brush кисти this и возвращает ссылку на кисть this.

QBrush &QBrush::operator=(QBrush &&other)

Перемещающее присваивание other этому экземпляру QBrush.

Эта функция была добавлена в Qt 5.2.

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

Возвращает true , если кисть равна заданной кисти brush; в противном случае возвращает false.

Две кисти равны, если у них одинаковые стили, цвета и преобразования, а также одинаковые пиксельмапы или градиенты в зависимости от стиля.

См. также operator!=().