Partager via


PowerPoint.InsertSlideOptions interface

Représente les options disponibles lors de l’insertion de diapositives.

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

Exemples

// 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 = context.presentation;
    const selected = 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();
});

Propriétés

formatting

Spécifie la mise en forme à utiliser lors de l’insertion de diapositive. L’option par défaut consiste à utiliser « KeepSourceFormatting ».

sourceSlideIds

Spécifie les diapositives de la présentation source qui seront insérées dans la présentation actuelle. Ces diapositives sont représentées par leurs ID qui peuvent être récupérés à partir d’un Slide objet . L’ordre de ces diapositives est conservé pendant l’insertion. Si l’une des diapositives sources est introuvable ou si les ID ne sont pas valides, l’opération lève une SlideNotFound exception et aucune diapositive n’est insérée. Toutes les diapositives sources sont insérées quand sourceSlideIds n’est pas fourni (il s’agit du comportement par défaut).

targetSlideId

Spécifie où les nouvelles diapositives seront insérées dans la présentation. Les nouvelles diapositives seront insérées après la diapositive avec l’ID de diapositive donné. Si targetSlideId n’est pas fourni, les diapositives sont insérées au début de la présentation. Si targetSlideId n’est pas valide ou si elle pointe vers une diapositive non existante, l’opération lève une SlideNotFound exception et aucune diapositive n’est insérée.

Détails de la propriété

formatting

Spécifie la mise en forme à utiliser lors de l’insertion de diapositive. L’option par défaut consiste à utiliser « KeepSourceFormatting ».

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

Valeur de propriété

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

sourceSlideIds

Spécifie les diapositives de la présentation source qui seront insérées dans la présentation actuelle. Ces diapositives sont représentées par leurs ID qui peuvent être récupérés à partir d’un Slide objet . L’ordre de ces diapositives est conservé pendant l’insertion. Si l’une des diapositives sources est introuvable ou si les ID ne sont pas valides, l’opération lève une SlideNotFound exception et aucune diapositive n’est insérée. Toutes les diapositives sources sont insérées quand sourceSlideIds n’est pas fourni (il s’agit du comportement par défaut).

sourceSlideIds?: string[];

Valeur de propriété

string[]

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

targetSlideId

Spécifie où les nouvelles diapositives seront insérées dans la présentation. Les nouvelles diapositives seront insérées après la diapositive avec l’ID de diapositive donné. Si targetSlideId n’est pas fourni, les diapositives sont insérées au début de la présentation. Si targetSlideId n’est pas valide ou si elle pointe vers une diapositive non existante, l’opération lève une SlideNotFound exception et aucune diapositive n’est insérée.

targetSlideId?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]