PowerPoint.InsertSlideOptions interface

Paquet:

powerpoint

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

Remarques

Jeu d’API : PowerPointApi 1.2

Utilisateur

• PowerPoint.Presentation : insertSlidesFromBase64

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: 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();
});

Propriétés

formatting	Spécifie la mise en forme à utiliser lors de l’insertion de diapositives. L’option par défaut est d’utiliser « KeepSourceFormatting ».
sourceSlideIds	Spécifie les diapositives de la présentation source qui seront insérées dans la présentation en cours. Ces diapositives sont représentées par leur ID qui peut être récupéré à partir d’un Slide objet. L’ordre de ces diapositives est conservé lors de l’insertion. Si l’une des diapositives sources est introuvable ou si les ID ne sont pas valides, l’opération génère une SlideNotFound exception et aucune diapositive n’est insérée. Toutes les diapositives sources sont insérées si sourceSlideIds elles ne sont pas fournies (il s’agit du comportement par défaut).
targetSlideId	Spécifie l’emplacement 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 ce n’est pas le cas, les diapositives sont insérées au début de la présentation. Si targetSlideId elle n’est pas valide ou si elle pointe vers une diapositive inexistante, 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 diapositives. L’option par défaut est d’utiliser « KeepSourceFormatting ».

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

Valeur de propriété

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Remarques

Jeu d’API : PowerPointApi 1.2

sourceSlideIds

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

sourceSlideIds?: string[];

Valeur de propriété

string[]

Remarques

Jeu d’API : PowerPointApi 1.2

targetSlideId

Spécifie l’emplacement 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 ce n’est pas le cas, les diapositives sont insérées au début de la présentation. Si targetSlideId elle n’est pas valide ou si elle pointe vers une diapositive inexistante, l’opération lève une SlideNotFound exception et aucune diapositive n’est insérée.

targetSlideId?: string;

Valeur de propriété

string

Remarques

Jeu d’API : PowerPointApi 1.2