RadialGradient QML Type

绘制径向渐变。更多...

• 所有成员的列表，包括继承的成员

属性

• angle : real
• cached : bool
• gradient : Gradient
• horizontalOffset : real
• horizontalRadius : real
• source : variant
• verticalOffset : real
• verticalRadius : real

详细说明

渐变由两种或多种颜色构成，这些颜色之间无缝融合。颜色从元素中部开始，延伸至边缘。

示例

以下示例演示了如何应用该效果。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    RadialGradient {
        anchors.fill: parent
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 0.5; color: "black" }
        }
    }
}

属性文档

angle : real

此属性定义渐变围绕其中心点的旋转。只有当horizontalRadius 和verticalRadius 属性不相等时，该旋转才会显示出来。角度以度为单位，默认值为0 。

cached : bool

此属性允许将效果输出像素缓存起来，以提升渲染性能。

每次更改源或效果属性时，缓存中的像素都必须更新。由于需要额外的内存缓冲区来存储效果输出，因此内存消耗会增加。

当源或效果属性进行动画处理时，建议禁用缓存。

默认情况下，该属性设置为false 。

gradient : Gradient

渐变由两种或多种颜色定义，这些颜色会无缝融合。颜色通过一组GradientStop 子元素来指定，每个子元素都定义了渐变上从0.0到1.0之间的一个位置以及一种颜色。每个GradientStop 的位置通过设置position属性来定义，颜色则通过设置color属性来定义。

Gradient {
  GradientStop {
   position: 0.000
   color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
   position: 0.167
   color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
   position: 0.333
   color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
   position: 0.500
   color: Qt.rgba(0, 1, 1, 1)
   }
  GradientStop {
   position: 0.667
   color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
   position: 0.833
   color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
   position: 1.000
   color: Qt.rgba(1, 0, 0, 1)
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#F0F0F0"
  }
  GradientStop {
    position: 0.5
    color: "#000000"
  }
  GradientStop {
    position: 1.0
    color: "#F0F0F0"
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}

horizontalOffset : real

horizontalOffset 和verticalOffset 属性定义了渐变中心点相对于项目中心的偏移量（以像素为单位）。

取值范围为 -inf 到 inf。默认情况下，这些属性设置为0 。

horizontalRadius : real

horizontalRadius 和verticalRadius 属性用于定义径向渐变的形状和大小。如果两个半径相等，则渐变的形状为圆形；如果水平半径和垂直半径不同，则形状为椭圆形。半径以像素为单位。

取值范围为 -inf 到 inf。默认情况下，horizontalRadius 与宽度绑定，verticalRadius 与高度绑定。

source : variant

此属性定义将填充渐变的元素。源元素会被渲染到一个中间像素缓冲区中，并根据结果中的透明度值来确定渐变在显示中的像素可见性。源的默认值为未定义，此时整个效果区域都会被渐变填充。

verticalOffset : real

horizontalOffset 和 verticalOffset 属性定义了渐变中心点相对于项目中心的偏移量（以像素为单位）。

取值范围为 -inf 到 inf。默认情况下，这些属性设置为0 。

verticalRadius : real

horizontalRadius 和 verticalRadius 属性用于定义径向渐变的形状和大小。如果两个半径相等，渐变的形状为圆形；如果水平半径和垂直半径不同，则形状为椭圆形。半径以像素为单位。

取值范围为 -inf 到 inf。默认情况下，horizontalRadius 与宽度绑定，verticalRadius 与高度绑定。