Тип QML градиент

Определяет градиентное заполнение. Подробнее...

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

Свойства

• orientation : перечисление
• stops : список<GradientStop>

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

Градиент определяется двумя или более цветами, которые будут плавно смешиваться.

Цвета задаются набором дочерних элементов GradientStop, каждый из которых определяет положение на градиенте от 0,0 до 1,0 и цвет. Положение каждого GradientStop определяется установкой его свойства position; его цвет определяется с помощью свойства color.

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

Обратите внимание, что этот элемент не является визуальным представлением градиента. Для отображения градиента используйте визуальный элемент (например, Rectangle), который поддерживает использование градиентов.

Пример использования

В следующем примере объявляется элемент Rectangle с градиентом, начинающимся с красного, переходящего в желтый на одной трети высоты прямоугольника и заканчивающегося зеленым:

Rectangle {
    width: 100; height: 100
    gradient: Gradient {
        GradientStop { position: 0.0; color: "red" }
        GradientStop { position: 0.33; color: "yellow" }
        GradientStop { position: 1.0; color: "green" }
    }
}

Производительность и ограничения

Вычисление градиентов может быть вычислительно дорогим по сравнению с использованием сплошных заливок или изображений. Рассмотрите использование градиентов для статических элементов в пользовательском интерфейсе.

Начиная с Qt 5.12, линейные градиенты по вертикали и горизонтали могут применяться к элементам. Если вам необходимо применить наклонные градиенты, можно применить комбинацию поворота и обрезки к соответствующим элементам. Кроме того, рассмотрите использование QtQuick.Shapes::LinearGradient или QtGraphicalEffects::LinearGradient. Все эти подходы могут привести к дополнительным требованиям к производительности вашего приложения.

Использование анимаций, включающих остановки градиента, может не дать ожидаемого результата. Альтернативный способ анимирования градиентов — использование предварительно сгенерированных изображений или SVG-рисунков, содержащих градиенты.

См. также GradientStop.

Документация по свойствам

[since 5.12] orientation : перечисление

Установите это свойство, чтобы определить направление градиента.

• Gradient.Vertical - вертикальный градиент
• Gradient.Horizontal - горизонтальный градиент

По умолчанию используется Gradient.Vertical.

Это свойство было добавлено в Qt 5.12.

[default] stops : список<GradientStop>

Это свойство содержит градиентные остановки, описывающие градиент.

По умолчанию это свойство содержит пустой список.

Для задания градиентных остановок определите их как дочерние элементы градиента.