Class SpreadsheetTheme

电子表格主题

访问和修改现有主题。如需在电子表格中设置主题，请使用 Spreadsheet.setSpreadsheetTheme(theme)。

方法

方法	返回类型	简介
getConcreteColor(themeColorType)	Color	返回有效主题颜色类型的具体 Color。
getFontFamily()	String	返回主题的字体系列；如果是 null 主题，则返回 null。
getThemeColors()	ThemeColorType[]	返回当前主题的所有可能主题颜色类型的列表。
setConcreteColor(themeColorType, color)	SpreadsheetTheme	将此配色方案中与 ThemeColorType 关联的具体颜色设为指定颜色。
setConcreteColor(themeColorType, red, green, blue)	SpreadsheetTheme	将与此配色方案中的 ThemeColorType 关联的具体颜色设为 RGB 格式的给定颜色。
setFontFamily(fontFamily)	SpreadsheetTheme	设置主题的字体系列。

详细文档

getConcreteColor(themeColorType)

返回有效主题颜色类型的具体 Color。如果当前主题中未设置主题颜色类型，则会抛出异常。

参数

名称	类型	说明
themeColorType	ThemeColorType	主题颜色类型。

返回

Color - 混凝土色。

授权

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

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

---

getFontFamily()

返回主题的字体系列；如果是 null 主题，则返回 null。

返回

String - 主题字体系列。

授权

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

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

---

getThemeColors()

返回当前主题的所有可能主题颜色类型的列表。

返回

ThemeColorType[] - 主题颜色列表。

授权

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

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

---

setConcreteColor(themeColorType, color)

将此配色方案中与 ThemeColorType 关联的具体颜色设为指定颜色。

参数

名称	类型	说明
themeColorType	ThemeColorType	主题颜色类型。
color	Color	颜色。

返回

SpreadsheetTheme - 主题，用于链式调用。

授权

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

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

---

setConcreteColor(themeColorType, red, green, blue)

将与此配色方案中的 ThemeColorType 关联的具体颜色设为 RGB 格式的给定颜色。

参数

名称	类型	说明
themeColorType	ThemeColorType	主题颜色类型。
red	Integer	红色通道的值。
green	Integer	绿色通道的值。
blue	Integer	蓝色通道的值。

返回

SpreadsheetTheme - 主题，用于链式调用。

授权

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

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

---

setFontFamily(fontFamily)

设置主题的字体系列。

参数

名称	类型	说明
fontFamily	String	新的主题字体系列。

返回

SpreadsheetTheme - 此主题，用于链式调用。

授权

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

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