Class Selection

Sélection

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

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

Méthodes

MéthodeType renvoyéBrève description
getCurrentPage()PageRenvoie la valeur Page ou null actuellement active en l'absence de page active.
getPageElementRange()PageElementRangeRenvoie la collection PageElementRange d'instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()PageRangeRenvoie à PageRange une collection d'instances Page de la feuille Flimstrip qui sont sélectionnées, ou null si la sélection n'est pas du type SelectionType.PAGE.
getSelectionType()SelectionTypeRenvoie SelectionType.
getTableCellRange()TableCellRangeRenvoie la collection TableCellRange d'instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.
getTextRange()TextRangeRenvoie le TextRange sélectionné ou null si la sélection n'est pas du type SelectionType.TEXT.

Documentation détaillée

getCurrentPage()

Renvoie la valeur Page ou null actuellement active en l'absence de page active.

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

Aller-retour

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.

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

Aller-retour

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 à PageRange une collection d'instances Page de la feuille Flimstrip qui sont sélectionnées, ou null si la sélection n'est pas du type SelectionType.PAGE.

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

Aller-retour

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.

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

Aller-retour

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 d'instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.

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

Aller-retour

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 le TextRange sélectionné ou null si la sélection n'est pas du type SelectionType.TEXT.

TextRange représente deux scénarios:

1. Plage de texte sélectionnée. Par exemple, si une forme contenant le texte"Hello"et"He&tt"est sélectionnée, la plage renvoyée correspond à TextRange.getStartIndex() = 0 et à TextRange.getEndIndex() = 2.

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

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

Aller-retour

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