Class SpreadsheetTheme

SpreadsheetTheme

Access and modify existing themes. To set a theme on a spreadsheet, use Spreadsheet.setSpreadsheetTheme(theme) .

Methods

Method Return type Brief description
Color Returns the concrete Color for a valid theme color type.
String Returns the font family of the theme, or null if it's a null theme.
ThemeColorType[] Returns a list of all possible theme color types for the current theme.
SpreadsheetTheme Sets the concrete color associated with the ThemeColorType in this color scheme to the given color.
SpreadsheetTheme Sets the concrete color associated with the ThemeColorType in this color scheme to the given color in RGB format.
SpreadsheetTheme Sets the font family for the theme.

Detailed documentation

getConcreteColor(themeColorType)

Returns the concrete Color for a valid theme color type. Throws exception if the theme color type is not set in the current theme.

Parameters

Name Type Description
themeColorType
ThemeColorType Theme color type.

Return

Color — Concrete color.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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

getFontFamily()

Returns the font family of the theme, or null if it's a null theme.

Return

String — The theme font family.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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

getThemeColors()

Returns a list of all possible theme color types for the current theme.

Return

ThemeColorType[] — A list of theme colors.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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

setConcreteColor(themeColorType, color)

Sets the concrete color associated with the ThemeColorType in this color scheme to the given color.

Parameters

Name Type Description
themeColorType
ThemeColorType The theme color type.
color
Color The color.

Return

SpreadsheetTheme — The theme, for chaining.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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

setConcreteColor(themeColorType, red, green, blue)

Sets the concrete color associated with the ThemeColorType in this color scheme to the given color in RGB format.

Parameters

Name Type Description
themeColorType
ThemeColorType The theme color type.
red
Integer The value of red channel.
green
Integer The value of green channel.
blue
Integer The value of blue channel.

Return

SpreadsheetTheme — The theme, for chaining.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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

setFontFamily(fontFamily)

Sets the font family for the theme.

Parameters

Name Type Description
fontFamily
String The new theme font family.

Return

SpreadsheetTheme — This theme, for chaining.

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

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