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

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

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

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

 #include <QBrush>

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

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

• QBrush ()
• QBrush ( Qt::BrushStyle style )
• QBrush ( const QColor & color, Qt::BrushStyle style = Qt::SolidPattern )
• QBrush ( Qt::GlobalColor color, Qt::BrushStyle style = Qt::SolidPattern )
• QBrush ( const QColor & color, const QPixmap & pixmap )
• QBrush ( Qt::GlobalColor color, const QPixmap & pixmap )
• QBrush ( const QPixmap & pixmap )
• QBrush ( const QImage & image )
• QBrush ( const QBrush & other )
• QBrush ( const QGradient & gradient )
• ~QBrush ()
• const QColor & color () const
• const QGradient * gradient () const
• bool isOpaque () const
• const QMatrix & matrix () const
• void setColor ( const QColor & color )
• void setColor ( Qt::GlobalColor color )
• void setMatrix ( const QMatrix & matrix )
• void setStyle ( Qt::BrushStyle style )
• void setTexture ( const QPixmap & pixmap )
• void setTextureImage ( const QImage & image )
• void setTransform ( const QTransform & matrix )
• Qt::BrushStyle style () const
• QPixmap texture () const
• QImage textureImage () const
• QTransform transform () const
• operator QVariant () const
• bool operator!= ( const QBrush & brush ) const
• QBrush & operator= ( const QBrush & brush )
• bool operator== ( const QBrush & brush ) const

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

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

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

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

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

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

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

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

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