Главная · Все классы · Все функции · Обзоры

Описание класса QBrush
[Модуль QtGui]

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

 #include <QBrush>

• Список всех членов, включая унаследованные
• Поддерживаемые члены Qt 3

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

Связанные нечлены класса

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

Класс 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, если кисть полностью прозрачна, иначе false. Кисть считается непрозрачной, если:

• Альфа-компонент color() составляет 255.
• Её texture() не имеет альфа-канала и это не QBitmap.
• У всех цветов в gradient() есть альфа-компонент, который составляет 255.

Чтобы указать стиль и цвет линий и контуров, используйте QPainter 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() и setPixmap().

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

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

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

Смотрите также setColor() и setPixmap().

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().

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 и возвращает указатель на текущую кисть.

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

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

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

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

Связанные нечлены класса

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

Записывает кисть brush в переданный поток stream и возвращает ссылку на поток stream.

Смотрите также Формат операторов QDataStream.

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

Читает кисть brush из потока stream и возвращает ссылку на поток stream.

Смотрите также Формат операторов QDataStream.