PowerPoint.Slide class
Représente une seule diapositive d’une présentation.
- Extends
Remarques
[ Ensemble d’API : PowerPointApi 1.2 ]
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();
});
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. |
| custom |
Retourne une collection de composants XML personnalisés dans la diapositive. |
| hyperlinks | Retourne une collection de liens hypertexte dans la diapositive. |
| id | Obtient l’ID unique de la diapositive. |
| layout | Obtient la disposition de la diapositive. |
| shapes | Retourne une collection de formes dans la diapositive. |
| slide |
Obtient l’objet |
| 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 |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| set |
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 |
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é
customXmlParts
Retourne une collection de composants XML personnalisés dans la diapositive.
readonly customXmlParts: PowerPoint.CustomXmlPartCollection;Valeur de propriété
Remarques
hyperlinks
Retourne une collection de liens hypertexte dans la diapositive.
readonly hyperlinks: PowerPoint.HyperlinkCollection;Valeur de propriété
Remarques
id
Obtient l’ID unique de la diapositive.
readonly id: string;Valeur de propriété
string
Remarques
layout
Obtient la disposition de la diapositive.
readonly layout: PowerPoint.SlideLayout;Valeur de propriété
Remarques
shapes
Retourne une collection de formes dans la diapositive.
readonly shapes: PowerPoint.ShapeCollection;Valeur de propriété
Remarques
slideMaster
Obtient l’objet SlideMaster qui représente le contenu par défaut de la diapositive.
readonly slideMaster: PowerPoint.SlideMaster;Valeur de propriété
Remarques
tags
Retourne une collection de balises dans la diapositive.
readonly tags: PowerPoint.TagCollection;Valeur de propriété
Remarques
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: PowerPoint.SlideScopedCollection = 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
Fournit des options pour les propriétés de l’objet à charger.
Retours
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
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
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: 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");
await context.sync();
const shapes: PowerPoint.ShapeCollection = slide1.shapes;
const shape1: PowerPoint.Shape = shapes.getItemAt(0);
const shape2: PowerPoint.Shape = 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.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;