渐变 QML 类型
定义渐变填充。 更多信息...
导入声明 | import QtQuick |
继承自 |
属性
- orientation : 枚举
- stops : 列表
详细描述
渐变由两种或多种颜色组成,它们将被平滑混合。
颜色由一组 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公司和/或全球其他国家的注册商标。所有其他商标均为各自业主的财产。