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éthode	Type renvoyé	Brève description
getCurrentPage()	Page|null	Renvoie le Page actuellement actif ou null s'il n'y a pas de page active.
getPageElementRange()	PageElementRange|null	Renvoie la collection PageElementRange des instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()	PageRange|null	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.
getSelectionType()	SelectionType	Renvoie SelectionType.
getTableCellRange()	TableCellRange|null	Renvoie la collection TableCellRange des instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.
getTextRange()	TextRange|null	Renvoie 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.

La commande 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() = 2.

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