Class ColorScheme
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
详细文档
getConcreteColor(theme)
返回此配色方案中与 ThemeColorType 关联的具体 Color。
返回的颜色保证不是 ThemeColor 的实例。
参数
返回
Color - 与此方案中的主题颜色类型对应的具体颜色。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getThemeColors()
返回配色方案中所有可能的主题颜色类型的列表。
返回
ThemeColorType[] - 此方案中可能的主题颜色类型。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, color)
将此配色方案中与 ThemeColorType 关联的具体颜色设为指定颜色。
参数
返回
ColorScheme - 此配色方案，用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, red, green, blue)
将与此配色方案中的 ThemeColorType 关联的具体颜色设为 RGB 格式的给定颜色。
参数
| 名称 | 类型 | 说明 |
type | ThemeColorType | 主题颜色类型。 |
red | Integer | 要将主题颜色类型设置为的颜色的红色值（介于 0 和 255 之间）。 |
green | Integer | 要将主题颜色类型设置为的颜色的绿色值（介于 0 和 255 之间）。 |
blue | Integer | 要将主题颜色类型设置为的颜色的蓝色值（介于 0 和 255 之间）。 |
返回
ColorScheme - 此配色方案，用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, hexColor)
将此配色方案中与 ThemeColorType 关联的具体颜色设为十六进制格式的指定颜色。
十六进制字符串必须采用“#RRGGBB”格式。
参数
| 名称 | 类型 | 说明 |
type | ThemeColorType | 主题颜色类型。 |
hexColor | String | 要将主题颜色类型设置为的十六进制颜色，例如“#F304a7”。 |
返回
ColorScheme - 此配色方案，用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eA color scheme maps theme color types to actual colors used in Google Slides.\u003c/p\u003e\n"],["\u003cp\u003eYou can get and set the concrete color associated with a theme color type using \u003ccode\u003egetConcreteColor()\u003c/code\u003e and \u003ccode\u003esetConcreteColor()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetThemeColors()\u003c/code\u003e returns a list of all possible theme color types in a color scheme.\u003c/p\u003e\n"],["\u003cp\u003eColor schemes allow you to control the colors used for different elements within your presentations.\u003c/p\u003e\n"],["\u003cp\u003eThese methods require authorization with specific scopes to access and modify presentations.\u003c/p\u003e\n"]]],[],null,["# Class ColorScheme\n\nColorScheme\n\nA color scheme defines a mapping from members of [ThemeColorType](/apps-script/reference/slides/theme-color-type) to the actual colors used\nto render them. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [getConcreteColor(theme)](#getConcreteColor(ThemeColorType)) | [Color](/apps-script/reference/slides/color) | Returns the concrete [Color](/apps-script/reference/slides/color) associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme. |\n| [getThemeColors()](#getThemeColors()) | [ThemeColorType[]](/apps-script/reference/slides/theme-color-type) | Returns a list of all possible theme color types in a color scheme. |\n| [setConcreteColor(type, color)](#setConcreteColor(ThemeColorType,Color)) | [ColorScheme](#) | Sets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the given color. |\n| [setConcreteColor(type, red, green, blue)](#setConcreteColor(ThemeColorType,Integer,Integer,Integer)) | [ColorScheme](#) | Sets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the given color in RGB format. |\n| [setConcreteColor(type, hexColor)](#setConcreteColor(ThemeColorType,String)) | [ColorScheme](#) | Sets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the given color in HEX format. |\n\nDetailed documentation\n----------------------\n\n### `get``Concrete``Color(theme)`\n\nReturns the concrete [Color](/apps-script/reference/slides/color) associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color\nscheme.\n\nThe returned color is guaranteed to not be an instance of [ThemeColor](/apps-script/reference/slides/theme-color).\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|------------------------------------------------------------------|----------------------------------------------------|\n| `theme` | [ThemeColorType](/apps-script/reference/slides/theme-color-type) | The theme color to derive the concrete color from. |\n\n#### Return\n\n\n[Color](/apps-script/reference/slides/color) --- The concrete color corresponding the theme color type in this scheme.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Theme``Colors()`\n\nReturns a list of all possible theme color types in a color scheme.\n\n#### Return\n\n\n[ThemeColorType[]](/apps-script/reference/slides/theme-color-type) --- The possible theme color types in this scheme.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `set``Concrete``Color(type, color)`\n\nSets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the\ngiven color.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|------------------------------------------------------------------|-------------------------------------------|\n| `type` | [ThemeColorType](/apps-script/reference/slides/theme-color-type) | The theme color type. |\n| `color` | [Color](/apps-script/reference/slides/color) | The color to set the theme color type to. |\n\n#### Return\n\n\n[ColorScheme](#) --- This color scheme, for chaining.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `set``Concrete``Color(type, red, green, blue)`\n\nSets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the\ngiven color in RGB format.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|------------------------------------------------------------------|----------------------------------------------------------------------------------|\n| `type` | [ThemeColorType](/apps-script/reference/slides/theme-color-type) | The theme color type. |\n| `red` | `Integer` | The red value of the color to set the theme color type to (between 0 and 255). |\n| `green` | `Integer` | The green value of the color to set the theme color type to (between 0 and 255). |\n| `blue` | `Integer` | The blue value of the color to set the theme color type to (between 0 and 255). |\n\n#### Return\n\n\n[ColorScheme](#) --- This color scheme, for chaining.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `set``Concrete``Color(type, hexColor)`\n\nSets the concrete color associated with the [ThemeColorType](/apps-script/reference/slides/theme-color-type) in this color scheme to the\ngiven color in HEX format.\n\nThe hex string must be in the format '#RRGGBB'.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|------------------------------------------------------------------|------------------------------------------------------------------|\n| `type` | [ThemeColorType](/apps-script/reference/slides/theme-color-type) | The theme color type. |\n| `hex``Color` | `String` | The hex color to set the theme color type to, such as '#F304a7'. |\n\n#### Return\n\n\n[ColorScheme](#) --- This color scheme, for chaining.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]
