Тип QML Gradient

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

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

Свойства

• 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.

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

orientation : перечисление

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

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

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

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

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

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

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

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