PowerPoint.ThemeColorScheme class

Paket:
powerpoint

Stellt ein Designfarbschema dar.

Extends
OfficeExtension.ClientObject

Hinweise

API-Satz: PowerPointApi 1.10

Verwendet von

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-theme-color-scheme.yaml

// Resets accent colors on the first slide to default Office theme values and updates swatches if present.
await PowerPoint.run(async (context) => {
  const slide = context.presentation.slides.getItemAt(0);
  const colorScheme: PowerPoint.ThemeColorScheme = slide.themeColorScheme;

  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent1, "#4472C4");
  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent2, "#ED7D31");
  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent3, "#A9D18E");
  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent4, "#FFC000");
  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent5, "#5B9BD5");
  colorScheme.setThemeColor(PowerPoint.ThemeColor.accent6, "#70AD47");
  await context.sync();

  await updateSwatches(context, slide);
  console.log("Accent colors reset to default Office theme values on slide 1.");
});

Eigenschaften

context

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

Methoden

getThemeColor(color)

Ruft den Farbwert für den angegebenen ThemeColorab.
getThemeColor(color)

Ruft den Farbwert für den angegebenen ThemeColorab.
setThemeColor(color, rgbColor)

Legt den Farbwert für die angegebene ThemeColor.
setThemeColor(color, rgbColor)

Legt den Farbwert für die angegebene ThemeColor.
toJSON()

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche PowerPoint.ThemeColorScheme Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als PowerPoint.Interfaces.ThemeColorSchemeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

Details zur Eigenschaft

context

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

PowerPoint.RequestContext

Details zur Methode

getThemeColor(color)

Ruft den Farbwert für den angegebenen ThemeColorab.

getThemeColor(color: PowerPoint.ThemeColor): OfficeExtension.ClientResult<string>;

Parameter

color
PowerPoint.ThemeColor

Die Designfarbe. Die Werte none und mixed sind für diese API ungültig.

Gibt zurück

OfficeExtension.ClientResult<string>

Der Farbwert in #RRGGBB Format (z. B. "FFA500").

Hinweise

API-Satz: PowerPointApi 1.10

getThemeColor(color)

Ruft den Farbwert für den angegebenen ThemeColorab.

getThemeColor(color: "Mixed" | "None" | "Accent1" | "Accent2" | "Accent3" | "Accent4" | "Accent5" | "Accent6" | "Dark1" | "Dark2" | "FollowedHyperlink" | "Hyperlink" | "Light1" | "Light2"): OfficeExtension.ClientResult<string>;

Parameter

color

"Mixed" | "None" | "Accent1" | "Accent2" | "Accent3" | "Accent4" | "Accent5" | "Accent6" | "Dark1" | "Dark2" | "FollowedHyperlink" | "Hyperlink" | "Light1" | "Light2"

Die Designfarbe. Die Werte none und mixed sind für diese API ungültig.

Gibt zurück

OfficeExtension.ClientResult<string>

Der Farbwert in #RRGGBB Format (z. B. "FFA500").

Hinweise

API-Satz: PowerPointApi 1.10

setThemeColor(color, rgbColor)

Legt den Farbwert für die angegebene ThemeColor.

setThemeColor(color: PowerPoint.ThemeColor, rgbColor: string): void;

Parameter

color
PowerPoint.ThemeColor

Die Designfarbe. Die Werte none und mixed sind für diese API ungültig.

rgbColor

string

Der Farbwert in #RRGGBB Format (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").

Gibt zurück

void

Hinweise

API-Satz: PowerPointApi 1.10

setThemeColor(color, rgbColor)

Legt den Farbwert für die angegebene ThemeColor.

setThemeColor(color: "Mixed" | "None" | "Accent1" | "Accent2" | "Accent3" | "Accent4" | "Accent5" | "Accent6" | "Dark1" | "Dark2" | "FollowedHyperlink" | "Hyperlink" | "Light1" | "Light2", rgbColor: string): void;

Parameter

color

"Mixed" | "None" | "Accent1" | "Accent2" | "Accent3" | "Accent4" | "Accent5" | "Accent6" | "Dark1" | "Dark2" | "FollowedHyperlink" | "Hyperlink" | "Light1" | "Light2"

Die Designfarbe. Die Werte none und mixed sind für diese API ungültig.

rgbColor

string

Der Farbwert in #RRGGBB Format (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").

Gibt zurück

void

Hinweise

API-Satz: PowerPointApi 1.10

toJSON()

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche PowerPoint.ThemeColorScheme Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als PowerPoint.Interfaces.ThemeColorSchemeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): {
            [key: string]: string;
        };

Gibt zurück

{ [key: string]: string; }