Тип 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.

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

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

Установите это свойство для определения направления градиента.

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

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

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

[по умолчанию] stops : список<GradientStop>

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

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

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