PowerPoint.InsertSlideOptions interface

Paquete:

powerpoint

Representa las opciones disponibles al insertar diapositivas.

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

Ejemplos

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

Propiedades

formatting	Especifica el formato que se va a usar durante la inserción de diapositivas. La opción predeterminada es usar "KeepSourceFormatting".
sourceSlideIds	Especifica las diapositivas de la presentación de origen que se insertarán en la presentación actual. Estas diapositivas se representan mediante sus identificadores que se pueden recuperar de un Slide objeto . El orden de estas diapositivas se conserva durante la inserción. Si no se encuentra ninguna de las diapositivas de origen o si los identificadores no son válidos, la operación produce una SlideNotFound excepción y no se insertarán diapositivas. Todas las diapositivas de origen se insertarán cuando sourceSlideIds no se proporcione (este es el comportamiento predeterminado).
targetSlideId	Especifica dónde se insertarán las nuevas diapositivas en la presentación. Las nuevas diapositivas se insertarán después de la diapositiva con el identificador de diapositiva especificado. Si targetSlideId no se proporciona, las diapositivas se insertarán al principio de la presentación. Si targetSlideId no es válido o si apunta a una diapositiva no existente, la operación produce una SlideNotFound excepción y no se insertará ninguna diapositiva.

Detalles de las propiedades

formatting

Especifica el formato que se va a usar durante la inserción de diapositivas. La opción predeterminada es usar "KeepSourceFormatting".

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

Valor de propiedad

PowerPoint.InsertSlideFormatting | "KeepSourceFormatting" | "UseDestinationTheme"

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

sourceSlideIds

Especifica las diapositivas de la presentación de origen que se insertarán en la presentación actual. Estas diapositivas se representan mediante sus identificadores que se pueden recuperar de un Slide objeto . El orden de estas diapositivas se conserva durante la inserción. Si no se encuentra ninguna de las diapositivas de origen o si los identificadores no son válidos, la operación produce una SlideNotFound excepción y no se insertarán diapositivas. Todas las diapositivas de origen se insertarán cuando sourceSlideIds no se proporcione (este es el comportamiento predeterminado).

sourceSlideIds?: string[];

Valor de propiedad

string[]

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

targetSlideId

Especifica dónde se insertarán las nuevas diapositivas en la presentación. Las nuevas diapositivas se insertarán después de la diapositiva con el identificador de diapositiva especificado. Si targetSlideId no se proporciona, las diapositivas se insertarán al principio de la presentación. Si targetSlideId no es válido o si apunta a una diapositiva no existente, la operación produce una SlideNotFound excepción y no se insertará ninguna diapositiva.

targetSlideId?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]