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. |
| export |
Exporte la diapositive vers son propre fichier de présentation, retourné sous forme de données codées en Base64. |
| get |
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 |
| 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();
});
});
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
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;