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 des instances PageElement sélectionnées ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()PageRangeRenvoie à la fonction PageRange une collection d'instances Page dans la bande passante qui sont sélectionnées ou null si la sélection n'est pas de type SelectionType.PAGE.
getSelectionType()SelectionTypeRenvoie la valeur SelectionType.
getTableCellRange()TableCellRangeRenvoie la collection TableCellRange des instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée.
getTextRange()TextRangeRenvoie la valeur TextRange sélectionnée ou la valeur null si la sélection n'est pas de 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());
}

Renvois

Page

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 des 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);
}

Renvois

PageElementRange

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

getPageRange()

Renvoie à la fonction PageRange une collection d'instances Page dans la bande passante qui sont sélectionnées ou null si la sélection n'est pas de 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);
}
}

Renvois

PageRange

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

getSelectionType()

Renvoie la valeur 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());
}

Renvois

SelectionType

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.

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);
}

Renvois

TableCellRange

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

getTextRange()

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

Le TextRange représente deux scénarios:

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

2. Position du curseur. Par exemple, si une forme contient le texte "Hello" et que le curseur se trouve après "H", ("H|ello"), la plage renvoyée contient 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());
}

Renvois

TextRange

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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