PowerPoint.SlideMasterCollection class

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.

context: RequestContext;

Valor da propriedade

Obtém os itens filhos carregados nesta coleção.

readonly items: PowerPoint.SlideMaster[];

Valor da propriedade

Obtém o número de Slides Mestres na coleção.

getCount(): OfficeExtension.ClientResult<number>;

Retornos

O número de Slides Mestres na coleção.

Comentários

Conjunto de APIs: PowerPointApi 1.3

Obtém um Slide Mestre usando sua ID exclusiva.

getItem(key: string): PowerPoint.SlideMaster;

Parâmetros

Retornos

O Slide Mestre com a ID exclusiva. Se tal Slide Mestre não existir, um erro será gerado.

Comentários

Conjunto de APIs: PowerPointApi 1.3

Obtém um Slide Mestre usando seu índice baseado em zero na coleção.

getItemAt(index: number): PowerPoint.SlideMaster;

Parâmetros

Retornos

O Slide Mestre no índice fornecido. Um erro será gerado se o índice estiver fora do intervalo.

Comentários

Conjunto de APIs: PowerPointApi 1.3

Obtém um Slide Mestre usando sua ID exclusiva. Se tal Slide Mestre não existir, um objeto com uma isNullObject propriedade definida como true será retornado. Para obter mais informações, consulte métodos e propriedades *OrNullObject.

getItemOrNullObject(id: string): PowerPoint.SlideMaster;

Parâmetros

Retornos

O Slide Mestre com a ID exclusiva.

Comentários

Conjunto de APIs: PowerPointApi 1.3

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: PowerPoint.Interfaces.SlideMasterCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.SlideMasterCollection;

Parâmetros

Retornos

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): PowerPoint.SlideMasterCollection;

Parâmetros

Retornos

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/add-slides.yaml

await PowerPoint.run(async function(context) {
  // Load information about all the slide masters and associated layouts.
  const slideMasters: PowerPoint.SlideMasterCollection = context.presentation.slideMasters.load("id, name, layouts/items/name, layouts/items/id");
  await context.sync();

  // Log the name and ID of each slide master.
  for (let i = 0; i < slideMasters.items.length; i++) {
    console.log("Master name: " + slideMasters.items[i].name);
    console.log("Master ID: " + slideMasters.items[i].id);

    // Log the name and ID of each slide layout in the slide master.
    const layoutsInMaster: PowerPoint.SlideLayoutCollection = slideMasters.items[i].layouts;
    for (let j = 0; j < layoutsInMaster.items.length; j++) {
      console.log("    Layout name: " + layoutsInMaster.items[j].name + " Layout ID: " + layoutsInMaster.items[j].id);
    }
  }
});

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.SlideMasterCollection;

Parâmetros

Retornos

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é passado para JSON.stringify(). (JSON.stringify, por sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto original PowerPoint.SlideMasterCollection é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado como PowerPoint.Interfaces.SlideMasterCollectionData) que contém uma matriz "items" com cópias superficiais de todas as propriedades carregadas dos itens da coleção.

toJSON(): PowerPoint.Interfaces.SlideMasterCollectionData;

Retornos