Class PageBackground

页面背景

描述页面的背景

方法

方法	返回类型	简介
getPictureFill()	PictureFill	获取此背景的经过拉伸的图片填充，如果背景填充类型不是 PageBackgroundType.PICTURE，则返回 null。
getSolidFill()	SolidFill	获取此背景的纯色填充，如果背景填充类型不是 PageBackgroundType.SOLID，则返回 null。
getType()	PageBackgroundType	获取此页面背景的类型。
isVisible()	Boolean	背景是否可见。
setPictureFill(blobSource)	void	将指定图片 Blob 中的图片设置为页面背景。
setPictureFill(imageUrl)	void	将提供的网址中的图片设置为页面背景。
setSolidFill(color)	void	将实心填充设置为给定的 Color。
setSolidFill(color, alpha)	void	将实心填充设置为给定的 alpha 和 Color。
setSolidFill(red, green, blue)	void	将实心填充设置为给定的 RGB 值。
setSolidFill(red, green, blue, alpha)	void	将实心填充设置为指定的 Alpha 和 RGB 值。
setSolidFill(hexString)	void	将纯色填充设置为给定的十六进制颜色字符串。
setSolidFill(hexString, alpha)	void	将纯色填充设置为给定的 Alpha 值和十六进制颜色字符串。
setSolidFill(color)	void	将实心填充设置为给定的 ThemeColorType。
setSolidFill(color, alpha)	void	将实心填充设置为给定的 alpha 和 ThemeColorType。
setTransparent()	void	将背景设置为透明。

详细文档

getPictureFill()

获取此背景的经过拉伸的图片填充，如果背景填充类型不是 PageBackgroundType.PICTURE，则返回 null。

返回

PictureFill

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getSolidFill()

获取此背景的纯色填充，如果背景填充类型不是 PageBackgroundType.SOLID，则返回 null。

返回

SolidFill

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getType()

获取此页面背景的类型。

返回

PageBackgroundType

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

isVisible()

背景是否可见。

返回

Boolean

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setPictureFill(blobSource)

将指定图片 Blob 中的图片设置为页面背景。系统会拉伸图片，使其与页面的尺寸相匹配。

插入图片会从 BlobSource 中提取一次，并存储一个副本以在演示文稿中显示。图片大小不得超过 50MB，不得超过 2500 万像素，且必须为 PNG、JPEG 或 GIF 格式。

参数

名称	类型	说明
blobSource	BlobSource	图片数据。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setPictureFill(imageUrl)

将提供的网址中的图片设为页面背景。图片会拉伸以匹配页面的尺寸。

插入图片会从网址中提取一次图片，并存储一个副本以供在演示文稿中显示。图片大小不得超过 50MB，不得超过 2500 万像素，且必须为 PNG、JPEG 或 GIF 格式。

提供的网址必须可供公开访问，且不得大于 2KB。网址本身会随图片一起保存，并通过 PictureFill.getSourceUrl() 公开。

参数

名称	类型	说明
imageUrl	String	用于下载图片的网址。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(color)

将实心填充设置为给定的 Color。

参数

名称	类型	说明
color	Color

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(color, alpha)

将实心填充设置为给定的 alpha 和 Color。

参数

名称	类型	说明
color	Color
alpha	Number

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(red, green, blue)

将实心填充设置为给定的 RGB 值。

参数

名称	类型	说明
red	Integer
green	Integer
blue	Integer

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(red, green, blue, alpha)

将实心填充设置为指定的 Alpha 和 RGB 值。

参数

名称	类型	说明
red	Integer
green	Integer
blue	Integer
alpha	Number

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(hexString)

将纯色填充设置为给定的十六进制颜色字符串。

十六进制字符串必须采用“#RRGGBB”格式。例如，粉色将表示为“#FFC0CB”。

参数

名称	类型	说明
hexString	String

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(hexString, alpha)

将纯色填充设置为给定的 Alpha 值和十六进制颜色字符串。

十六进制字符串必须采用“#RRGGBB”格式。例如，粉色将表示为“#FFC0CB”。

参数

名称	类型	说明
hexString	String
alpha	Number

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(color)

将实心填充设置为给定的 ThemeColorType。

参数

名称	类型	说明
color	ThemeColorType

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setSolidFill(color, alpha)

将实心填充设置为给定的 alpha 和 ThemeColorType。

参数

名称	类型	说明
color	ThemeColorType
alpha	Number

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setTransparent()

将背景设置为透明。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations