Qt:Документация 4.3.2/qbrush

Материал из Wiki.crossplatform.ru

Версия от 09:08, 14 ноября 2008; Root (Обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

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

Image:trolltech-logo.png

Содержание

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

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

 #include <QBrush>

[править] Открытые функции

[править] Связанные не-члены

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

[править] Подробное описание

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

Кисть характеризуется стилем, цветом, градиентом и текстурой.

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

center

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() определяет pixmap, используемых при текущем стиле Qt::TexturePattern. Вы можете создать кисть с текстурой, предоставив pixmap, когда кисть создается или с помощью setTexture().

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

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

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


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

Конструктор копий.

[править]
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

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

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

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

[править]
void QBrush::setColor ( const QColor & color )

Устанавливает цвет кисти в color.

Note that calling setColor() will not make a difference if the style is a gradient. The same is the case if the style is Qt::TexturePattern style unless the current texture is a QBitmap.

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

[править]
void QBrush::setColor ( Qt::GlobalColor color )

Данная перегруженная функция-член предоставлена для удобства.

Устанавливает цвет кисти в color.

[править]
void QBrush::setMatrix ( const QMatrix & matrix )

Sets matrix as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with QPainter transformation matrix to produce the final result.

Эта функция введена в 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 )

Sets the brush image to image. The style is set to Qt::TexturePattern.

The current brush color will only have an effect for monochrome images, i.e. for QImage::depth() == 1.

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

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

[править]
void QBrush::setTransform ( const QTransform & matrix )

Sets matrix as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with QPainter transformation matrix to produce the final result.

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

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

[править]
Qt::BrushStyle QBrush::style () const

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

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

[править]
QPixmap QBrush::texture () const

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

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

[править]
QImage QBrush::textureImage () const

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

If the texture was set as a QPixmap it will be converted to a 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 данной кисти и возвращает указатель данной кисти.

[править]
bool QBrush::operator== ( const QBrush & brush ) const

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

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

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


[править] Связанные не-члены

[править]
QDataStream & operator<< ( QDataStream & stream, const QBrush & brush )

Эта перегруженная функция предоставлена для удобства.

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

Смотри также Format of the QDataStream Operators.

[править]
QDataStream & operator>> ( QDataStream & stream, QBrush & brush )

Эта перегруженная функция предоставлена для удобства.

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

Смотри также Format of the QDataStream Operators.

Перевод: akorchagin

Обсуждение и критика перевода Здесь...


Copyright © 2007 Trolltech Trademarks
Qt 4.3.2