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éthode | Type renvoyé | Brève description |
---|---|---|
getCurrentPage() | Page | Renvoie la valeur Page ou null actuellement active en l'absence de page 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 à 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() | SelectionType | Renvoie SelectionType . |
getTableCellRange() | TableCellRange | Renvoie la collection TableCellRange d'instances TableCell sélectionnées ou null si aucune instance TableCell n'est sélectionnée. |
getTextRange() | TextRange | Renvoie 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
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
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
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
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
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
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