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 l'élément Page ou null actuellement actif s'il n'y a aucune page active. |
getPageElementRange() | PageElementRange | Renvoie la collection PageElementRange des instances PageElement qui sont
sélectionné ou null si aucune instance PageElement n'est sélectionnée. |
getPageRange() | PageRange | 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 . |
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 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
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
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
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
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
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
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