WPS 加载项开发 > 表格 API 参考 > PictureFormat > 方法 > PictureFormat.IncrementBrightness 方法
按指定数值改变图片亮度。可以使用 Brightness 属性设置图片的绝对亮度。

语法

表达式.IncrementBrightness(Increment)

表达式   一个代表 PictureFormat 对象的变量。

参数

名称 必选/可选 数据类型 说明
Increment 必选 Single 指定图片的 Brightness 属性值的改变量。正值表示图片变亮，负值表示图片变暗。

说明

调整图片亮度不能超出 Brightness 属性的界限。例如，如果 Brightness 属性初始设为 0.9 并将 Increment 参数指定为 0.3，则结果亮度为 1.0（Brightness 属性的上限）而不是 1.2。

示例

本示例创建 myDocument 上第一个形状的副本，再移动该副本并使之变暗。要执行本示例，第一个形状必须是图片或 OLE 对象。

示例代码 
let duplicate = Worksheets.Item(1).Shapes.Item(1).Duplicate()
duplicate.PictureFormat.IncrementBrightness(-0.2)
duplicate.IncrementLeft(50)
duplicate.IncrementTop(50)


请参阅