Cette page a été traduite par l'API Cloud Translation.

Class SlidesApp

Crée et ouvre Presentations, qui peut être modifié.

// Open a presentation by ID.
var preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

Propriétés

Propriété	Type	Description
`AlignmentPosition`	`AlignmentPosition`	Énumération des types de positions d'alignement.
`ArrowStyle`	`ArrowStyle`	Énumération des différents styles de flèche qu'un `Line` peut avoir.
`AutoTextType`	`AutoTextType`	Énumération des types de texte automatique.
`AutofitType`	`AutofitType`	Énumération des types d'ajustement automatique.
`CellMergeState`	`CellMergeState`	Énumération des différents états de fusion d'une cellule de table.
`ColorType`	`ColorType`	Énumération des types de couleurs.
`ContentAlignment`	`ContentAlignment`	Énumération des valeurs permettant de spécifier l'alignement du contenu.
`DashStyle`	`DashStyle`	Énumération des différents styles de tiret qu'un `Line` peut avoir.
`FillType`	`FillType`	Énumération des types de remplissage.
`LineCategory`	`LineCategory`	Énumération des catégories de `Line`.
`LineFillType`	`LineFillType`	Énumération des types de `LineFill`.
`LineType`	`LineType`	Énumération des types de `Line`.
`LinkType`	`LinkType`	Énumération des types de liens.
`ListPreset`	`ListPreset`	Énumération des types de listes de préréglages.
`PageBackgroundType`	`PageBackgroundType`	Énumération des types d'arrière-plan de la page.
`PageElementType`	`PageElementType`	Énumération des types d'éléments de page.
`PageType`	`PageType`	Énumération des types de pages.
`ParagraphAlignment`	`ParagraphAlignment`	Énumération des types d'alignement de paragraphe.
`PlaceholderType`	`PlaceholderType`	Énumération des types d'espaces réservés.
`PredefinedLayout`	`PredefinedLayout`	Énumération des mises en page prédéfinies.
`SelectionType`	`SelectionType`	Énumération des types de sélections.
`ShapeType`	`ShapeType`	Énumération des types de formes.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	Énumération des types d'intégration de graphique Sheets.
`SlideLinkingMode`	`SlideLinkingMode`	Énumération montrant comment associer Slides.
`SlidePosition`	`SlidePosition`	Énumération des types de positions de diapositives.
`SpacingMode`	`SpacingMode`	Énumération des types de modes d'espacement.
`TextBaselineOffset`	`TextBaselineOffset`	Énumération des types de décalage du texte de référence.
`TextDirection`	`TextDirection`	Énumération des types d'itinéraires textuels.
`ThemeColorType`	`ThemeColorType`	Énumération des couleurs du thème.
`VideoSourceType`	`VideoSourceType`	Énumération des types de source vidéo.

Méthodes

Méthode	Type renvoyé	Brève description
`create(name)`	`Presentation`	Crée et ouvre un élément `Presentation`.
`getActivePresentation()`	`Presentation`	Renvoie la présentation active pour laquelle le script est lié à un conteneur ou `null` s'il n'y a pas de présentation active.
`getUi()`	`Ui`	Renvoie une instance de l'environnement d'interface utilisateur de la présentation qui permet au script d'ajouter des fonctionnalités telles que des menus, des boîtes de dialogue et des barres latérales.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	Renvoie une nouvelle `AffineTransformBuilder` pour créer un `AffineTransform`.
`openById(id)`	`Presentation`	Ouvre `Presentation` avec l'ID donné.
`openByUrl(url)`	`Presentation`	Ouvre `Presentation` avec l'URL donnée.

Documentation détaillée

`create(name)`

Crée et ouvre un élément Presentation.

Paramètres

Nom	Type	Description
`name`	`String`	Nom à attribuer à la présentation créée.

Aller-retour

Presentation : présentation portant le nom donné

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

https://www.googleapis.com/auth/presentations

`getActivePresentation()`

Renvoie la présentation active pour laquelle le script est lié à un conteneur ou null s'il n'y a pas de présentation active. Pour interagir avec une présentation dans laquelle le script n'est pas lié à des conteneurs, utilisez plutôt openById(id).

// Get the current presentation to which this script is bound.
var presentation = SlidesApp.getActivePresentation();

Si la présentation est déjà ouverte, la même instance de présentation est renvoyée.

Aller-retour

Presentation

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getUi()`

Renvoie une instance de l'environnement d'interface utilisateur de la présentation qui permet au script d'ajouter des fonctionnalités telles que des menus, des boîtes de dialogue et des barres latérales. Un script ne peut interagir avec l'interface utilisateur de l'instance actuelle d'une présentation ouverte que s'il est lié à la présentation. Pour en savoir plus, consultez les guides des menus, ainsi que les boîtes de dialogue et les barres latérales.

// Add a custom menu to the active presentation, including a separator and a sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SlidesApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Aller-retour

Ui

`newAffineTransformBuilder()`

Renvoie une nouvelle AffineTransformBuilder pour créer un AffineTransform. Le compilateur est prédéfini avec la transformation affine d'identité.

Aller-retour

AffineTransformBuilder

`openById(id)`

Ouvre Presentation avec l'ID donné.

// Open a presentation by ID.
var presentation = SlidesApp.openById('docId');

Si la présentation est déjà ouverte, la même instance de présentation est renvoyée.

Paramètres

Nom	Type	Description
`id`	`String`

Aller-retour

Presentation : présentation associée à l'ID indiqué

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/presentations

`openByUrl(url)`

Ouvre Presentation avec l'URL donnée.

// Open a presentation by URL.
var presentation = SlidesApp.openByUrl('https://docs.google.com/presentation/d/docId/edit');

Si la présentation est déjà ouverte, la même instance de présentation est renvoyée.

Paramètres

Nom	Type	Description
`url`	`String`

Aller-retour

Presentation : présentation associée à l'URL donnée

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/presentations