Class NotesPage

NotesPage

Page de notes dans une présentation.

Ces pages contiennent le contenu des documents de présentation, y compris une forme contenant les commentaires du présentateur de la diapositive. Chaque diapositive est associée à une page de notes. Seul le texte de la forme des notes du présentateur peut être modifié.

Méthodes

MéthodeType renvoyéBrève description
getGroups()Group[]Renvoie la liste des objets Group sur la page.
getImages()Image[]Renvoie la liste des objets Image sur la page.
getLines()Line[]Renvoie la liste des objets Line sur la page.
getObjectId()StringObtient l'ID unique de la page.
getPageElementById(id)PageElement|nullRenvoie le PageElement sur la page avec l'ID donné, ou null si aucun n'existe.
getPageElements()PageElement[]Renvoie la liste des objets PageElement affichés sur la page.
getPlaceholder(placeholderType)PageElement|nullRenvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié ou null si aucun espace réservé correspondant n'est présent.
getPlaceholder(placeholderType, placeholderIndex)PageElement|nullRenvoie l'objet PageElement d'espace réservé pour un PlaceholderType et un index d'espace réservé spécifiés, ou null si l'espace réservé n'est pas présent.
getPlaceholders()PageElement[]Renvoie la liste des objets PageElement d'espace réservé sur la page.
getShapes()Shape[]Renvoie la liste des objets Shape sur la page.
getSheetsCharts()SheetsChart[]Renvoie la liste des objets SheetsChart sur la page.
getSpeakerNotesShape()ShapeRécupère la forme contenant les notes du présentateur sur la page.
getTables()Table[]Renvoie la liste des objets Table sur la page.
getVideos()Video[]Renvoie la liste des objets Video sur la page.
getWordArts()WordArt[]Renvoie la liste des objets WordArt sur la page.
replaceAllText(findText, replaceText)IntegerRemplace toutes les instances du texte à rechercher par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)IntegerRemplace toutes les instances du texte à rechercher par le texte de remplacement.

Documentation détaillée

getGroups()

Renvoie la liste des objets Group sur la page.

Renvois

Group[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getImages()

Renvoie la liste des objets Image sur la page.

Renvois

Image[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getLines()

Renvoie la liste des objets Line sur la page.

Renvois

Line[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getObjectId()

Obtient l'ID unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPageElementById(id)

Renvoie le PageElement sur la page avec l'ID donné, ou null si aucun n'existe.

Paramètres

NomTypeDescription
idStringID de l'élément de page récupéré.

Renvois

PageElement|null : élément de page avec l'ID donné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPageElements()

Renvoie la liste des objets PageElement affichés sur la page.

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPlaceholder(placeholderType)

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié ou null si aucun espace réservé correspondant n'est présent.

S'il existe plusieurs espaces réservés du même type, celui dont l'index est le plus petit est renvoyé. S'il existe plusieurs espaces réservés correspondants avec le même index, le premier espace réservé de la collection d'éléments de la page est renvoyé. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Paramètres

NomTypeDescription
placeholderTypePlaceholderTypeType d'espace réservé à mettre en correspondance.

Renvois

PageElement|null : élément de page de l'espace réservé ou null si aucun n'est trouvé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPlaceholder(placeholderType, placeholderIndex)

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType et un index d'espace réservé spécifiés, ou null si l'espace réservé n'est pas présent.

S'il existe plusieurs espaces réservés avec le même type et le même index, il renvoie le premier espace réservé de la collection d'éléments de page. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Paramètres

NomTypeDescription
placeholderTypePlaceholderTypeType d'espace réservé à mettre en correspondance.
placeholderIndexIntegerIndex de l'espace réservé à mettre en correspondance.

Renvois

PageElement|null : élément de page de l'espace réservé ou null si aucun n'est trouvé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPlaceholders()

Renvoie la liste des objets PageElement d'espace réservé sur la page. 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getShapes()

Renvoie la liste des objets Shape sur la page.

Renvois

Shape[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getSheetsCharts()

Renvoie la liste des objets SheetsChart sur la page.

Renvois

SheetsChart[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getSpeakerNotesShape()

Récupère la forme contenant les notes du présentateur sur la page.

Renvois

Shape

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getTables()

Renvoie la liste des objets Table sur la page.

Renvois

Table[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getVideos()

Renvoie la liste des objets Video sur la page.

Renvois

Video[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getWordArts()

Renvoie la liste des objets WordArt sur la page.

Renvois

WordArt[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

replaceAllText(findText, replaceText)

Remplace toutes les instances du texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à utiliser pour remplacer le texte correspondant.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

replaceAllText(findText, replaceText, matchCase)

Remplace toutes les instances du texte à rechercher par le texte de remplacement.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à utiliser pour remplacer le texte correspondant.
matchCaseBooleanSi la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche n'est pas sensible à la casse.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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