Class ColorScheme
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Farbschema
Ein Farbschema definiert eine Zuordnung von Mitgliedern von ThemeColorType
zu den tatsächlichen Farben, die zum Rendern verwendet werden.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
getConcreteColor(theme) | Color | Gibt den konkreten Color zurück, der dem ThemeColorType in diesem Farbschema zugeordnet ist. |
getThemeColors() | ThemeColorType[] | Gibt eine Liste aller möglichen Designfarbentypen in einem Farbschema zurück. |
setConcreteColor(type, color) | ColorScheme | Damit wird die Farbe festgelegt, die mit dem ThemeColorType in diesem Farbschema verknüpft ist. |
setConcreteColor(type, red, green, blue) | ColorScheme | Hiermit wird die Farbe, die mit der ThemeColorType in diesem Farbschema verknüpft ist, auf die angegebene Farbe im RGB-Format festgelegt. |
setConcreteColor(type, hexColor) | ColorScheme | Hiermit wird die Farbe festgelegt, die der ThemeColorType in diesem Farbschema zugeordnet ist. Sie wird durch die angegebene Farbe im HEX-Format ersetzt. |
Detaillierte Dokumentation
getConcreteColor(theme)
Gibt den konkreten Color
zurück, der dem ThemeColorType
in diesem Farbschema zugeordnet ist.
Die zurückgegebene Farbe ist garantiert keine Instanz von ThemeColor
.
Parameter
Name | Typ | Beschreibung |
theme | ThemeColorType | Die Designfarbe, aus der die konkrete Farbe abgeleitet werden soll. |
Rückflug
Color
: Die Farbe, die dem Farbtyp des Themas in diesem Schema entspricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getThemeColors()
Gibt eine Liste aller möglichen Designfarbentypen in einem Farbschema zurück.
Rückflug
ThemeColorType[]
: Die möglichen Designfarbtypen in diesem Schema.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, color)
Damit wird die Farbe festgelegt, die mit dem ThemeColorType
in diesem Farbschema verknüpft ist.
Parameter
Name | Typ | Beschreibung |
type | ThemeColorType | Der Farbtyp des Designs. |
color | Color | Die Farbe, die als Designfarbtyp festgelegt werden soll. |
Rückflug
ColorScheme
– Dieses Farbschema, zur Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, red, green, blue)
Hiermit wird die Farbe, die mit der ThemeColorType
in diesem Farbschema verknüpft ist, auf die angegebene Farbe im RGB-Format festgelegt.
Parameter
Name | Typ | Beschreibung |
type | ThemeColorType | Der Farbtyp des Designs. |
red | Integer | Der rote Wert der Farbe, auf die der Designfarbtyp festgelegt werden soll (zwischen 0 und 255). |
green | Integer | Der grüne Wert der Farbe, auf die der Designfarbtyp festgelegt werden soll (zwischen 0 und 255). |
blue | Integer | Der Blauwert der Farbe, auf die der Designfarbtyp festgelegt werden soll (zwischen 0 und 255). |
Rückflug
ColorScheme
– Dieses Farbschema, zur Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setConcreteColor(type, hexColor)
Hiermit wird die Farbe festgelegt, die der ThemeColorType
in diesem Farbschema zugeordnet ist. Sie wird durch die angegebene Farbe im HEX-Format ersetzt.
Der Hexadezimalstring muss das Format #RRGGBB haben.
Parameter
Name | Typ | Beschreibung |
type | ThemeColorType | Der Farbtyp des Designs. |
hexColor | String | Die Hexadezimalfarbe, die als Designfarbtyp festgelegt werden soll, z. B. #F304a7. |
Rückflug
ColorScheme
– Dieses Farbschema, zur Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\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`"]]