Главная · Все пространства имен · Все классы · Основные классы · Классы по группам · Модули · Функции

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

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

 #include <QBrush>

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

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


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

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

КонтурыЧтобы указать стиль и цвет линий и контуров, используйте 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. Кисть считается непрозрачной, если:

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.


Copyright © 2008 Nokia Торговые марки
Qt 4.4.3