Class Selection

Sélection

Sélection de l'utilisateur dans la présentation active.

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
const selectionType = selection.getSelectionType();

Méthodes

MéthodeType renvoyéBrève description
getCurrentPage()Page|nullRenvoie le Page actuellement actif ou null s'il n'y a pas de page active.
getPageElementRange()PageElementRange|nullRenvoie la collection PageElementRange des instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()PageRange|nullRenvoie PageRange, une collection d'instances Page dans la bande de film qui sont sélectionnées, ou null si la sélection n'est pas de type SelectionType.PAGE.
getSelectionType()SelectionTypeRenvoie SelectionType.
getTableCellRange()TableCellRange|nullRenvoie la collection TableCellRange des instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.
getTextRange()TextRange|nullRenvoie le TextRange sélectionné ou null si la sélection n'est pas de type SelectionType.TEXT.

Documentation détaillée

getCurrentPage()

Renvoie le Page actuellement actif ou null s'il n'y a pas de page active.

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
if (currentPage != null) {
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Renvois

Page|null

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

getPageElementRange()

Renvoie la collection PageElementRange des instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE_ELEMENT) {
  const currentPage = selection.getCurrentPage();
  const pageElements = selection.getPageElementRange().getPageElements();
  Logger.log(`Number of page elements selected: ${pageElements.length}`);
}

Renvois

PageElementRange|null

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

getPageRange()

Renvoie PageRange, une collection d'instances Page dans la bande de film qui sont sélectionnées, ou null si la sélection n'est pas de type SelectionType.PAGE.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE) {
  const pageRange = selection.getPageRange();
  Logger.log(
      `Number of pages in the flimstrip selected: ${
          pageRange.getPages().length}`,
  );
}

Renvois

PageRange|null

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

getSelectionType()

Renvoie SelectionType.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.CURRENT_PAGE) {
  const currentPage = selection.getCurrentPage();
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Renvois

SelectionType

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

getTableCellRange()

Renvoie la collection TableCellRange des instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TABLE_CELL) {
  const currentPage = selection.getCurrentPage();
  const tableCells = selection.getTableCellRange().getTableCells();
  const table = tableCells[0].getParentTable();
  Logger.log(`Number of table cells selected: ${tableCells.length}`);
}

Renvois

TableCellRange|null

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

getTextRange()

Renvoie le TextRange sélectionné ou null si la sélection n'est pas de type SelectionType.TEXT.

TextRange représente deux scénarios :

1. Plage de texte sélectionnée. Par exemple, si une forme contient le texte "Bonjour" et que "Bon" est sélectionné, la plage renvoyée a TextRange.getStartIndex() = 0 et TextRange.getEndIndex() = 3.

2. Position du curseur. Par exemple, si une forme contient le texte "Bonjour" et que le curseur se trouve après le "B" ("B|onjour"), la plage renvoyée a TextRange.getStartIndex() = 1 et TextRange.getEndIndex() = 1.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TEXT) {
  const currentPage = selection.getCurrentPage();
  const pageElement = selection.getPageElementRange().getPageElements()[0];
  const textRange = selection.getTextRange();
  Logger.log(`Text selected: ${textRange.asString()}`);
}

Renvois

TextRange|null

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