PowerPoint.InsertSlideOptions interface

Pacote:

powerpoint

Representa as opções disponíveis ao inserir diapositivos.

Comentários

[ Conjunto de API: PowerPointApi 1.2 ]

Exemplos

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

await PowerPoint.run(async function(context) {
    // Get the ID of the first selected slide.
    const presentation: PowerPoint.Presentation = context.presentation;
    const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
    selected.load("id");
    await context.sync();

    // Insert the other presentation after the selected slide.
    const insertOptions: PowerPoint.InsertSlideOptions = {
        formatting: PowerPoint.InsertSlideFormatting.useDestinationTheme,
        targetSlideId: selected.id
    };
    presentation.insertSlidesFromBase64(chosenFileBase64, insertOptions);
    await context.sync();
});

Propriedades

formatting	Especifica a formatação a utilizar durante a inserção de diapositivos. A opção predefinida é utilizar "KeepSourceFormatting".
sourceSlideIds	Especifica os diapositivos da apresentação de origem que serão inseridos na apresentação atual. Estes diapositivos são representados pelos respetivos IDs que podem ser obtidos a partir de um Slide objeto. A ordem destes diapositivos é preservada durante a inserção. Se algum dos diapositivos de origem não for encontrado ou se os IDs forem inválidos, a operação gera uma SlideNotFound exceção e não serão inseridos diapositivos. Todos os diapositivos de origem serão inseridos quando sourceSlideIds não forem fornecidos (este é o comportamento predefinido).
targetSlideId	Especifica onde na apresentação serão inseridos os novos diapositivos. Os novos diapositivos serão inseridos após o diapositivo com o ID de diapositivo especificado. Se targetSlideId não for fornecido, os diapositivos serão inseridos no início da apresentação. Se targetSlideId for inválido ou se estiver a apontar para um diapositivo não existente, a operação gera uma SlideNotFound exceção e não serão inseridos diapositivos.

Detalhes da propriedade

formatting

Especifica a formatação a utilizar durante a inserção de diapositivos. A opção predefinida é utilizar "KeepSourceFormatting".

formatting?: PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme";

Valor da propriedade

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Comentários

[ Conjunto de API: PowerPointApi 1.2 ]

sourceSlideIds

Especifica os diapositivos da apresentação de origem que serão inseridos na apresentação atual. Estes diapositivos são representados pelos respetivos IDs que podem ser obtidos a partir de um Slide objeto. A ordem destes diapositivos é preservada durante a inserção. Se algum dos diapositivos de origem não for encontrado ou se os IDs forem inválidos, a operação gera uma SlideNotFound exceção e não serão inseridos diapositivos. Todos os diapositivos de origem serão inseridos quando sourceSlideIds não forem fornecidos (este é o comportamento predefinido).

sourceSlideIds?: string[];

Valor da propriedade

string[]

Comentários

[ Conjunto de API: PowerPointApi 1.2 ]

targetSlideId

Especifica onde na apresentação serão inseridos os novos diapositivos. Os novos diapositivos serão inseridos após o diapositivo com o ID de diapositivo especificado. Se targetSlideId não for fornecido, os diapositivos serão inseridos no início da apresentação. Se targetSlideId for inválido ou se estiver a apontar para um diapositivo não existente, a operação gera uma SlideNotFound exceção e não serão inseridos diapositivos.

targetSlideId?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.2 ]