渐变 QML 类型

定义渐变填充。 更多信息...

导入声明import QtQuick
继承自

ShapeGradient

属性

详细描述

渐变由两种或多种颜色组成,它们将被平滑混合。

颜色由一组 GradientStop 子项指定,每个子项定义渐变上从 0.0 到 1.0 的位置和一个颜色。每个 GradientStop 的位置通过设置其 position 属性来定义;其颜色使用其 color 属性定义。

没有渐变停点的渐变以纯白色填充进行渲染。

请注意,此项目不是渐变的视觉表示。要显示渐变,请使用支持渐变的视觉项目(如 Rectangle)。

示例用法

以下示例声明了一个从红色开始,在矩形高度的 1/3 处混合到黄色,并以绿色结束的 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。


stops : 列表<GradientStop> [默认值]

此属性持有描述渐变的渐变停止点。

默认情况下,此属性包含一个空列表。

要设置渐变停止点,将它们定义为渐变元素的子元素。


© 2024 Qt公司。本文件所包含的文档贡献版权属于各自的业主。所提供的文档是根据自由软件基金会发布的GNU自由文档许可证第1.3版条款许可的。Qt和相应商标是芬兰Qt公司和/或全球其他国家的注册商标。所有其他商标均为各自业主的财产。