PowerPoint.Slide class

Paquet:

powerpoint

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

Extends

OfficeExtension.ClientObject

Remarques

[ Ensemble d’API : PowerPointApi 1.2 ]

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.
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.
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 (typé 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.

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 ]

tags

Retourne une collection de balises dans la diapositive.

readonly tags: PowerPoint.TagCollection;

Valeur de propriété

PowerPoint.TagCollection

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

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

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 (typé 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