PowerPoint.Slide class

Référence

Paquet:: powerpoint

Représente une seule diapositive d’une présentation.

Extends: OfficeExtension.ClientObject

Remarques

Propriétés

context	Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.
id	Obtient l’ID unique de la diapositive.
layout	Obtient la disposition de la diapositive.
shapes	Retourne une collection de formes dans la diapositive.
slideMaster	Obtient l’objet `SlideMaster` qui représente le contenu par défaut de la diapositive.
tags	Retourne une collection de balises dans la diapositive.

Méthodes

delete()	Supprime la diapositive de la présentation. Ne fait rien si la diapositive n’existe pas.
exportAsBase64()	Exporte la diapositive vers son propre fichier de présentation, retourné sous forme de données codées en base64.
getImageAsBase64(options)	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.
load(options)	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)	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)	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.
setSelectedShapes(shapeIds)	Sélectionne les formes spécifiées. La sélection de forme existante est remplacée par la nouvelle sélection.
toJSON()	Remplace la méthode JavaScript `toJSON()` afin de fournir une sortie plus utile lorsqu’un objet API est passé à `JSON.stringify()`. (`JSON.stringify`appelle à son tour la `toJSON` méthode de l’objet qui lui est passé.) Alors que l’objet PowerPoint.Slide d’origine est un objet API, la `toJSON` méthode renvoie un objet JavaScript brut (tapé en tant `PowerPoint.Interfaces.SlideData`que ) qui contient des copies superficielles de toutes les propriétés enfants chargées à partir de l’objet d’origine.

Détails de la propriété

context

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 propriété

PowerPoint.RequestContext

id

Obtient l’ID unique de la diapositive.

readonly id: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

layout

Obtient la disposition de la diapositive.

readonly layout: PowerPoint.SlideLayout;

Valeur de propriété

PowerPoint.SlideLayout

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

shapes

Retourne une collection de formes dans la diapositive.

readonly shapes: PowerPoint.ShapeCollection;

Valeur de propriété

PowerPoint.ShapeCollection

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

slideMaster

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

readonly slideMaster: PowerPoint.SlideMaster;

Valeur de propriété

PowerPoint.SlideMaster

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Détails de la méthode

delete()

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

delete(): void;

Retours

void

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 = context.presentation.getSelectedSlides();
  const slideCount = slides.getCount();
  slides.load("items");
  await context.sync();
  slides.items.map((slide) => {
    slide.delete();
  });
});

exportAsBase64()

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.

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

exportAsBase64(): OfficeExtension.ClientResult<string>;

Retours

OfficeExtension.ClientResult<string>

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

getImageAsBase64(options)

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.

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

options: PowerPoint.SlideGetImageOptions

Optional. Options permettant de spécifier la taille souhaitée de l’image de diapositive.

Retours

OfficeExtension.ClientResult<string>

Chaîne base64 de l’image de diapositive au format PNG.

Remarques

[ Ensemble d’API : PowerPointApi BETA (PRÉVERSION UNIQUEMENT) ]

load(options)

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

options: PowerPoint.Interfaces.SlideLoadOptions

Fournit des options pour les propriétés de l’objet à charger.

Retours

PowerPoint.Slide

load(propertyNames)

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

propertyNames: string | string[]

Chaîne délimitée par des virgules ou tableau de chaînes qui spécifient les propriétés à charger.

Retours

PowerPoint.Slide

load(propertyNamesAndPaths)

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

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.

Retours

PowerPoint.Slide

setSelectedShapes(shapeIds)

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

shapeIds: string[]

Liste des ID de forme à sélectionner dans la diapositive. Si la liste est vide, la sélection est effacée.

Retours

void

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 = 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");
  await context.sync();
  const shapes = slide1.shapes;
  const shape1 = shapes.getItemAt(0);
  const shape2 = shapes.getItemAt(1);
  shape1.load("id");
  shape2.load("id");
  await context.sync();
  slide1.setSelectedShapes([shape1.id, shape2.id]);
  await context.sync();
});

toJSON()

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

toJSON(): PowerPoint.Interfaces.SlideData;

Retours

PowerPoint.Interfaces.SlideData

PowerPoint.Slide class

Remarques

Propriétés

Méthodes

Détails de la propriété

context

Valeur de propriété

id

Valeur de propriété

Remarques

layout

Valeur de propriété

Remarques

shapes

Valeur de propriété

Remarques

slideMaster

Valeur de propriété

Remarques

tags

Valeur de propriété

Remarques

Détails de la méthode

delete()

Retours

Remarques

Exemples

exportAsBase64()

Retours

Remarques

getImageAsBase64(options)

Paramètres

Retours

Remarques

load(options)

Paramètres

Retours

load(propertyNames)

Paramètres

Retours

load(propertyNamesAndPaths)

Paramètres

Retours

setSelectedShapes(shapeIds)

Paramètres

Retours

Remarques

Exemples

toJSON()

Retours

Commentaires

Ressources supplémentaires