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 l'élément Page ou null actuellement actif s'il n'y a aucune page active.
getPageElementRange()PageElementRangeRenvoie la collection PageElementRange des instances PageElement qui sont sélectionné ou null si aucune instance PageElement n'est sélectionnée.
getPageRange()PageRangeRenvoie à PageRange une collection d'instances Page dans la fenêtre fine qui sont sélectionné ou null si la sélection n'est pas de 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 l'élément TextRange sélectionné ou null si la sélection n'est pas de type. SelectionType.TEXT

Documentation détaillée

getCurrentPage()

Renvoie l'élément Page ou null actuellement actif s'il n'y a aucune 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 correspondant à 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 qui sont sélectionné 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 correspondant à 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 dans la fenêtre fine qui sont sélectionné 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 correspondant à 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());
}

Renvois

SelectionType

Autorisation

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

Renvois

TableCellRange

Autorisation

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

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

getTextRange()

Renvoie l'élément TextRange sélectionné ou 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 comporte le texte "Hello" et "He" est sélectionnée, la plage renvoyée contient TextRange.getStartIndex() = 0, et TextRange.getEndIndex() = ; 2.

2. Position du curseur. Par exemple, si une forme comporte 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 correspondant à un ou plusieurs des champs d'application suivants:

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