Class SpreadsheetTheme

电子表格主题

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

方法

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

详细文档

getConcreteColor(themeColorType)

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

参数

名称类型说明
themeColorTypeThemeColorType主题颜色类型。

返回

Color - 混凝土颜色。

授权

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

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

getFontFamily()

返回主题的字体系列;如果主题为 null,则返回 null

返回

String|null - 主题字体系列。

授权

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

  • 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 关联的具体颜色设置为指定颜色。

参数

名称类型说明
themeColorTypeThemeColorType主题颜色类型。
colorColor颜色。

返回

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

授权

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

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

setConcreteColor(themeColorType, red, green, blue)

将此配色方案中与 ThemeColorType 关联的具体颜色设置为以 RGB 格式表示的指定颜色。

参数

名称类型说明
themeColorTypeThemeColorType主题颜色类型。
redInteger红色通道的值。
greenInteger绿色通道的值。
blueInteger蓝色通道的值。

返回

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

授权

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

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

setFontFamily(fontFamily)

为主题设置字体系列。

参数

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

返回

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

授权

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

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