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	Renvoie l'Page ou l'null actuellement actif, ou null si aucune page n'est active.
getPageElementRange()	PageElementRange	Renvoie la collection PageElementRange d'instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()	PageRange	Renvoie la PageRange une collection d'instances Page dans la pellicule sélectionnées ou null si la sélection n'est pas de type SelectionType.PAGE.
getSelectionType()	SelectionType	Renvoie SelectionType.
getTableCellRange()	TableCellRange	Renvoie la collection TableCellRange des instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.
getTextRange()	TextRange	Renvoie la TextRange sélectionnée ou null si la sélection n'est pas de type SelectionType.TEXT.

Documentation détaillée

getCurrentPage()

Renvoie l'Page ou l'null actuellement actif, ou null si aucune page n'est active.

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

Renvois

Page

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

---

getPageElementRange()

Renvoie la collection PageElementRange d'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

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

---

getPageRange()

Renvoie la PageRange une collection d'instances Page dans la pellicule 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

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

---

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 champs d'application 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

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

---

getTextRange()

Renvoie la TextRange sélectionnée 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 "Il" est sélectionné, la plage renvoyée est 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 "B" ("B|onjour"), la plage renvoyée est 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

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