Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Описание Класса QGradient
^{[модуль QtGui]}

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

#include <QGradient>

Наследуется QConicalGradient, QLinearGradient и QRadialGradient.

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

Открытые Типы

• enum Spread { PadSpread, RepeatSpread, ReflectSpread }
• enum Type { LinearGradient, RadialGradient, ConicalGradient }

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

• void setColorAt ( qreal pos, const QColor & color )
• void setSpread ( Spread method )
• void setStops ( const QGradientStops & stops )
• Spread spread () const
• QGradientStops stops () const
• Type type () const
• bool operator== ( const QGradient & gradient )

Связанные Не-Члены

• typedef QGradientStop
• typedef QGradientStops

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

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

В настоящее время Qt поддерживает три типа заливки: линейная, радиальная и коническая. Каждая из них представлена подклассом QGradient: QLinearGradient, QRadialGradient и QConicalGradient.

Цвета градиента задаются с помощью фиксированных точек, для которых задаются позиция и цвет. Набор фиксированных точек описывает заполнение области градиента. Диагональный линейный градиент от черного (100, 100) к белому (200, 200) может быть задан подобно следующему:

        QLinearGradient linearGrad(QPointF(100, 100), QPointF(200, 200));
        linearGrad.setColorAt(0, Qt::black);
        linearGrad.setColorAt(1, Qt::white);

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

        QRadialGradient radialGrad(QPointF(100, 100), 100);
        radialGrad.setColorAt(0, Qt::red);
        radialGrad.setColorAt(0.5, Qt::blue);
        radialGrad.setColorAt(1, Qt::green);

Возможно повторить или отразить градиент вне заданной области его распростанения. По умолчанию внешняя область заполняется цветом ближайшей фиксированной точки.

См. также QLinearGradient, QRadialGradient и QConicalGradient.

Описание Типов Членов

enum QGradient::Spread

Определяет как должна быть заполнена внешняя область градиента.

enum QGradient::Type

Определяет тип градиента.

Описание Функций-Членов

void QGradient::setColorAt ( qreal pos, const QColor & color )

Устанавливает новую фиксированную точку в относительной позиции pos с цветом color. Позиция pos должна находиться в интервале от 0 до 1.

void QGradient::setSpread ( Spread method )

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

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

void QGradient::setStops ( const QGradientStops & stops )

Заменяет текущий набор фиксированных точек на stops. Позиции фиксированных точек должны находиться в интрервале от 0 до 1 и должны быть отсортированы по возрастанию.

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

Spread QGradient::spread () const

Возвращает метод заполнения используемый текущим градиентом. Значение по умолчанию - PadSpread.

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

QGradientStops QGradient::stops () const

Возвращает фиксированные точки данного градиента.

Если градиент не имеет фиксированных точек, то он считается градиентом от черного в 0 к белому в 1.

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

Type QGradient::type () const

Возвращает тип градиента.

bool QGradient::operator== ( const QGradient & gradient )

Связанные Не-Члены

typedef QGradientStop

Typedef для QPair<qreal, QColor>.

typedef QGradientStops

Typedef для QVector<QGradientStop>.