PowerPoint.AddSlideOptions interface

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

Remarques

Jeu d’API : PowerPointApi 1.3

Utilisateur

Exemples

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

const chosenMaster = (document.getElementById("master-id") as HTMLInputElement).value;
const chosenLayout = (document.getElementById("layout-id") as HTMLInputElement).value;

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

index

Spécifie l’index de base 0 auquel la nouvelle diapositive doit être insérée. Si ce paramètre n’est pas spécifié ou si l’index spécifié est hors limites, la nouvelle diapositive est ajoutée à la fin de la présentation.

layoutId

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

slideMasterId

Spécifie l’ID d’un masque des diapositives à utiliser pour la nouvelle diapositive. Si aucune valeur slideMasterId n’est fournie, le masque des diapositives de la diapositive précédente est utilisé. S’il n’existe aucune diapositive précédente, le premier masque des diapositives de la présentation est utilisé.

Détails de la propriété

index

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Spécifie l’index de base 0 auquel la nouvelle diapositive doit être insérée. Si ce paramètre n’est pas spécifié ou si l’index spécifié est hors limites, la nouvelle diapositive est ajoutée à la fin de la présentation.

index?: number;

Valeur de propriété

number

Remarques

Jeu d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT)

layoutId

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

layoutId?: string;

Valeur de propriété

string

Remarques

Jeu d’API : PowerPointApi 1.3

slideMasterId

Spécifie l’ID d’un masque des diapositives à utiliser pour la nouvelle diapositive. Si aucune valeur slideMasterId n’est fournie, le masque des diapositives de la diapositive précédente est utilisé. S’il n’existe aucune diapositive précédente, le premier masque des diapositives de la présentation est utilisé.

slideMasterId?: string;

Valeur de propriété

string

Remarques

Jeu d’API : PowerPointApi 1.3