Compartilhar via


PowerPoint.ThemeColorScheme class

Representa um esquema de cores de tema.

Extends

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

Exemplos

// 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.");
});

Propriedades

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

Métodos

getThemeColor(color)

Obtém o valor de cor para o especificado ThemeColor.

getThemeColor(color)

Obtém o valor de cor para o especificado ThemeColor.

setThemeColor(color, rgbColor)

Define o valor de cor para o especificado ThemeColor.

setThemeColor(color, rgbColor)

Define o valor de cor para o especificado ThemeColor.

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original PowerPoint.ThemeColorScheme é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como PowerPoint.Interfaces.ThemeColorSchemeData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

Detalhes da propriedade

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

Detalhes do método

getThemeColor(color)

Obtém o valor de cor para o especificado ThemeColor.

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

Parâmetros

color
PowerPoint.ThemeColor

A cor do tema.

Retornos

O valor de cor no formato #RRGGBB (por exemplo, "FFA500").

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

getThemeColor(color)

Obtém o valor de cor para o especificado ThemeColor.

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

Parâmetros

color

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

A cor do tema.

Retornos

O valor de cor no formato #RRGGBB (por exemplo, "FFA500").

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

setThemeColor(color, rgbColor)

Define o valor de cor para o especificado ThemeColor.

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

Parâmetros

color
PowerPoint.ThemeColor

A cor do tema.

rgbColor

string

O valor de cor no formato #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").

Retornos

void

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

setThemeColor(color, rgbColor)

Define o valor de cor para o especificado ThemeColor.

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

Parâmetros

color

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

A cor do tema.

rgbColor

string

O valor de cor no formato #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").

Retornos

void

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original PowerPoint.ThemeColorScheme é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como PowerPoint.Interfaces.ThemeColorSchemeData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

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

Retornos

{ [key: string]: string; }