PowerPoint.Slide class

Obtient l’arrière-plan de la diapositive.

readonly background: PowerPoint.SlideBackground;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de la propriété

Retourne une collection de composants XML personnalisés dans la diapositive.

readonly customXmlParts: PowerPoint.CustomXmlPartCollection;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.7 ]

Retourne une collection de liens hypertexte dans la diapositive.

readonly hyperlinks: PowerPoint.HyperlinkCollection;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.6 ]

Obtient l’ID unique de la diapositive.

readonly id: string;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

Retourne l’index de base zéro de la diapositive représentant sa position dans la présentation.

readonly index: number;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Obtient la disposition de la diapositive.

readonly layout: PowerPoint.SlideLayout;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Retourne une collection de formes dans la diapositive.

readonly shapes: PowerPoint.ShapeCollection;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Obtient l’objet SlideMaster qui représente le contenu par défaut de la diapositive.

readonly slideMaster: PowerPoint.SlideMaster;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Retourne une collection de balises dans la diapositive.

readonly tags: PowerPoint.TagCollection;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Retourne le ThemeColorScheme de la diapositive.

readonly themeColorScheme: PowerPoint.ThemeColorScheme;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

Applique la disposition spécifiée à la diapositive, en modifiant sa conception et sa structure en fonction de la disposition choisie.

applyLayout(slideLayout: PowerPoint.SlideLayout): void;

Paramètres

Retourne

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Supprime la diapositive de la présentation. Ne fait rien si la diapositive n’existe pas.

delete(): void;

Retourne

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/get-set-slides.yaml

// Deletes the selected slides.
await PowerPoint.run(async (context) => {
  context.presentation.load("slides");
  await context.sync();
  const slides: PowerPoint.SlideScopedCollection = context.presentation.getSelectedSlides();
  const slideCount = slides.getCount();
  slides.load("items");
  await context.sync();
  slides.items.map((slide) => {
    slide.delete();
  });
});

Exporte la diapositive vers son propre fichier de présentation, retourné sous forme de données codées en Base64.

Remarque : cette méthode est optimisée pour exporter une seule diapositive. L’exportation de plusieurs diapositives peut avoir un impact sur les performances.

exportAsBase64(): OfficeExtension.ClientResult<string>;

Retourne

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

// Exports current slide.
await PowerPoint.run(async (context) => {
  const slide = context.presentation.getSelectedSlides().getItemAt(0);
  const slideBase64DataResult = slide.exportAsBase64();
  const imageBase64DataResult = slide.getImageAsBase64({ height: 300 });
  await context.sync();

  localStorage.setItem("exportedSlide", slideBase64DataResult.value);
  localStorage.setItem("exportedSlideImage", imageBase64DataResult.value);

  updateSlideImage(imageBase64DataResult.value);

  console.log("Slide was exported.");
});

Affiche une image de la diapositive. L’image est mise à l’échelle pour s’adapter aux dimensions souhaitées. Si la largeur et la hauteur ne sont pas spécifiées, la taille réelle de la diapositive est utilisée. Si une seule largeur ou hauteur est spécifiée, l’autre est calculée pour conserver les proportions.

getImageAsBase64(options?: PowerPoint.SlideGetImageOptions): OfficeExtension.ClientResult<string>;

Paramètres

Retourne

Chaîne codée en Base64 de l’image de diapositive au format PNG.

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Exemples

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

// Exports current slide.
await PowerPoint.run(async (context) => {
  const slide = context.presentation.getSelectedSlides().getItemAt(0);
  const slideBase64DataResult = slide.exportAsBase64();
  const imageBase64DataResult = slide.getImageAsBase64({ height: 300 });
  await context.sync();

  localStorage.setItem("exportedSlide", slideBase64DataResult.value);
  localStorage.setItem("exportedSlideImage", imageBase64DataResult.value);

  updateSlideImage(imageBase64DataResult.value);

  console.log("Slide was exported.");
});

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(options?: PowerPoint.Interfaces.SlideLoadOptions): PowerPoint.Slide;

Paramètres

Retourne

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNames?: string | string[]): PowerPoint.Slide;

Paramètres

Retourne

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.Slide;

Paramètres

Retourne

Déplace la diapositive vers une nouvelle position dans la présentation.

moveTo(slideIndex: number): void;

Paramètres

Retourne

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Sélectionne les formes spécifiées. La sélection de forme existante est remplacée par la nouvelle sélection.

setSelectedShapes(shapeIds: string[]): void;

Paramètres

Retourne

Remarques

[ Ensemble d’API : PowerPointApi 1.5 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/get-set-shapes.yaml

// Reselects shapes that were saved previously.
await PowerPoint.run(async (context) => {
  const slide1: PowerPoint.Slide = context.presentation.slides.getItem(savedSlideSelection[0]);
  await context.sync();
  slide1.setSelectedShapes(savedShapeSelection);
  await context.sync();
});

...

// Selects the first two shapes on slide 1.
await PowerPoint.run(async (context) => {
  context.presentation.load("slides");
  await context.sync();
  const slide1 = context.presentation.slides.getItemAt(0);
  slide1.load("shapes/items/type");
  await context.sync();

  const shapes = slide1.shapes.items.filter((item) => item.type === PowerPoint.ShapeType.geometricShape);
  const shape1: PowerPoint.Shape = shapes[0];
  const shape2: PowerPoint.Shape = shapes[1];
  shape1.load("id");
  shape2.load("id");
  await context.sync();

  console.log(`IDs: ${shape1.id}, ${shape2.id}`);
  slide1.setSelectedShapes([shape1.id, shape2.id]);
  await context.sync();
});

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine PowerPoint.Slide est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant PowerPoint.Interfaces.SlideDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): PowerPoint.Interfaces.SlideData;

Retourne