Partager via


PowerPoint.AddSlideOptions interface

Représente les options disponibles lors de l’ajout d’une nouvelle diapositive.

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Exemples

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

Propriétés

layoutId

Spécifie l’ID d’une disposition de diapositive à utiliser pour la nouvelle diapositive. Si aucun n’est layoutId fourni, mais qu’un slideMasterId est fourni, l’ID de la première disposition du masque des diapositives spécifié sera utilisé. Si aucun n’est slideMasterId fourni, mais qu’un layoutId est fourni, la disposition spécifiée doit être disponible pour le masque des diapositives par défaut (comme spécifié dans la slideMasterId description). Sinon, une erreur est levée.

slideMasterId

Spécifie l’ID d’un masque des diapositives à utiliser pour la nouvelle diapositive. Si aucun n’est slideMasterId fourni, le masque des diapositives de la diapositive précédente est utilisé. S’il n’y a pas de diapositive précédente, le premier masque des diapositives de la présentation sera utilisé.

Détails de la propriété

layoutId

Spécifie l’ID d’une disposition de diapositive à utiliser pour la nouvelle diapositive. Si aucun n’est layoutId fourni, mais qu’un slideMasterId est fourni, l’ID de la première disposition du masque des diapositives spécifié sera utilisé. Si aucun n’est slideMasterId fourni, mais qu’un layoutId est fourni, la disposition spécifiée doit être disponible pour le masque des diapositives par défaut (comme spécifié dans la slideMasterId description). Sinon, une erreur est levée.

layoutId?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

slideMasterId

Spécifie l’ID d’un masque des diapositives à utiliser pour la nouvelle diapositive. Si aucun n’est slideMasterId fourni, le masque des diapositives de la diapositive précédente est utilisé. S’il n’y a pas de diapositive précédente, le premier masque des diapositives de la présentation sera utilisé.

slideMasterId?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]