Compartilhar via


PowerPoint.AddSlideOptions interface

Representa as opções disponíveis ao adicionar um novo diapositivo.

Comentários

[ Conjunto de API: PowerPointApi 1.3 ]

Exemplos

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

const chosenMaster = $("#master-id").val() as string;
const chosenLayout = $("#layout-id").val() as string;

await PowerPoint.run(async function(context) {
  // Create a new slide using an existing master slide and layout.
  const newSlideOptions: PowerPoint.AddSlideOptions = {
    slideMasterId: chosenMaster, /* An ID from `Presentation.slideMasters`. */
    layoutId: chosenLayout /* An ID from `SlideMaster.layouts`. */
  };
  context.presentation.slides.add(newSlideOptions);
  await context.sync();
});

Propriedades

layoutId

Especifica o ID de um Esquema de Diapositivo a ser utilizado para o novo diapositivo. Se não layoutId for fornecido nenhum, mas for fornecido um slideMasterId , será utilizado o ID do primeiro esquema do Modelo Global de Diapositivos especificado. Se não slideMasterId for fornecido nenhum, mas for fornecido um layoutId , o esquema especificado tem de estar disponível para o Modelo Global de Diapositivos predefinido (conforme especificado na slideMasterId descrição). Caso contrário, será gerado um erro.

slideMasterId

Especifica o ID de um Modelo Global de Diapositivos a utilizar para o novo diapositivo. Se não for fornecido nenhum slideMasterId , será utilizado o Modelo Global de Diapositivos do diapositivo anterior. Se não existir um diapositivo anterior, será utilizado o primeiro Modelo Global de Diapositivos da apresentação.

Detalhes da propriedade

layoutId

Especifica o ID de um Esquema de Diapositivo a ser utilizado para o novo diapositivo. Se não layoutId for fornecido nenhum, mas for fornecido um slideMasterId , será utilizado o ID do primeiro esquema do Modelo Global de Diapositivos especificado. Se não slideMasterId for fornecido nenhum, mas for fornecido um layoutId , o esquema especificado tem de estar disponível para o Modelo Global de Diapositivos predefinido (conforme especificado na slideMasterId descrição). Caso contrário, será gerado um erro.

layoutId?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.3 ]

slideMasterId

Especifica o ID de um Modelo Global de Diapositivos a utilizar para o novo diapositivo. Se não for fornecido nenhum slideMasterId , será utilizado o Modelo Global de Diapositivos do diapositivo anterior. Se não existir um diapositivo anterior, será utilizado o primeiro Modelo Global de Diapositivos da apresentação.

slideMasterId?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.3 ]