Rectangle QML Type

用于决定矩形是否应使用抗锯齿。Antialiasing提供了有关此属性对性能影响的信息。

有半径的矩形默认为 true，否则为 false。

用于绘制矩形边框的宽度和颜色。

宽度为 1 时会创建一条细线。宽度为 0 或透明色则无线条。

边框将在矩形的边界内呈现。

如果pixelAligned 为true （默认值），则在按设备像素比例缩放后，渲染的边框宽度将四舍五入为整数像素。将pixelAligned 设置为false 将允许使用小数边框宽度，这在启用antialiasing 时可能比较理想。

该属性保存用于绘制左下角的半径。

如果未设置 bottomLeftRadius，则将使用radius 代替。如果 bottomLeftRadius 为零，则左下角将是锐角。

此属性在 Qt 6.7 中引入。

另请参阅 radius,topLeftRadius,topRightRadius, 和bottomRightRadius 。

该属性保存用于绘制右下角的半径。

如果未设置 bottomRightRadius，则将使用radius 代替。如果 bottomRightRadius 为零，该角将是锐角。

此属性在 Qt 6.7 中引入。

另请参阅 radius,topLeftRadius,topRightRadius, 和bottomLeftRadius 。

此属性保存用于填充矩形的颜色。

默认颜色为白色。

下面的示例显示了使用十六进制和命名颜色符号指定颜色的矩形：

Rectangle {
    color: "#00B000"
    width: 80; height: 80
}

Rectangle {
    color: "steelblue"
    y: 100; width: 80; height: 80
}

如果同时指定了渐变和颜色，则将使用渐变。

另请参阅 gradient 。

用于填充矩形的渐变色。

使用该属性可以构建简单的垂直或水平渐变。其他渐变可通过在矩形中添加旋转来形成。

Rectangle {
    width: 80; height: 80
    color: "lightsteelblue"
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        orientation: Gradient.Horizontal
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    rotation: 90
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

该属性也接受来自QGradient::Preset 的渐变预设。但请注意，由于矩形只支持简单的垂直或水平渐变，任何不支持角度的预设都将还原为最接近的表示。

Rectangle {
    width: 80; height: 80
    gradient: Gradient.NightFade
}

Rectangle {
    width: 80; height: 80
    gradient: "SunnyMorning"
}

如果同时指定了渐变和颜色，则将使用渐变。

另请参阅 Gradient 和color 。

该属性保存用于绘制圆角矩形的角半径。

如果半径不为零，矩形将绘制为圆角矩形，否则将绘制为普通矩形。也可以设置单个角半径（见下文）。这些值将覆盖半径。如果未设置（将其设置为undefined ），则将使用半径代替。

另请参阅 topLeftRadius,topRightRadius,bottomLeftRadius, 和bottomRightRadius 。

该属性保存用于绘制左上角的半径。

如果未设置 topLeftRadius，则将使用radius 代替。如果 topLeftRadius 为零，则角将是锐角。

此属性在 Qt 6.7 中引入。

另请参阅 radius,topRightRadius,bottomLeftRadius, 和bottomRightRadius 。

该属性保存用于绘制右上角的半径。

如果未设置 topRightRadius，则将使用radius 代替。如果 topRightRadius 为零，则将使用锐角。

此属性在 Qt 6.7 中引入。

另请参阅 radius,topLeftRadius,bottomLeftRadius, 和bottomRightRadius 。