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 格式。

参数

名称类型说明
blobSourceBlobSource图片数据。

授权

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

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

setPictureFill(imageUrl)

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

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

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

参数

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

授权

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

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

setSolidFill(color)

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

参数

名称类型说明
colorColor

授权

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

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

setSolidFill(color, alpha)

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

参数

名称类型说明
colorColor
alphaNumber

授权

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

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

setSolidFill(red, green, blue)

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

参数

名称类型说明
redInteger
greenInteger
blueInteger

授权

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

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

setSolidFill(red, green, blue, alpha)

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

参数

名称类型说明
redInteger
greenInteger
blueInteger
alphaNumber

授权

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

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

setSolidFill(hexString)

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

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

参数

名称类型说明
hexStringString

授权

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

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

setSolidFill(hexString, alpha)

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

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

参数

名称类型说明
hexStringString
alphaNumber

授权

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

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

setSolidFill(color)

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

参数

名称类型说明
colorThemeColorType

授权

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

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

setSolidFill(color, alpha)

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

参数

名称类型说明
colorThemeColorType
alphaNumber

授权

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

  • 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