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
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：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`"]]
