Class Selection

Selection

The user's selection in the active presentation.

constselection=SlidesApp.getActivePresentation().getSelection();constcurrentPage=selection.getCurrentPage();constselectionType=selection.getSelectionType();

Methods

MethodReturn typeBrief description
getCurrentPage()PageReturns the currently active Page or null if there is no active page.
getPageElementRange()PageElementRangeReturns the PageElementRange collection of PageElement instances that are selected or null if there are no PageElement instances selected.
getPageRange()PageRangeReturns the PageRange a collection of Page instances in the flimstrip that are selected or null if the selection is not of type SelectionType.PAGE.
getSelectionType()SelectionTypeReturns the SelectionType.
getTableCellRange()TableCellRangeReturns the TableCellRange collection of TableCell instances that are selected or null if there are no TableCell instances selected.
getTextRange()TextRangeReturns the TextRange that is selected or null if the selection is not of type SelectionType.TEXT.

Detailed documentation

getCurrentPage()

Returns the currently active Page or null if there is no active page.

constselection=SlidesApp.getActivePresentation().getSelection();constcurrentPage=selection.getCurrentPage();if(currentPage!=null){Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);}

Return

Page

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getPageElementRange()

Returns the PageElementRange collection of PageElement instances that are selected or null if there are no PageElement instances selected.

constselection=SlidesApp.getActivePresentation().getSelection();constselectionType=selection.getSelectionType();if(selectionType===SlidesApp.SelectionType.PAGE_ELEMENT){constcurrentPage=selection.getCurrentPage();constpageElements=selection.getPageElementRange().getPageElements();Logger.log(`Number of page elements selected: ${pageElements.length}`);}

Return

PageElementRange

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getPageRange()

Returns the PageRange a collection of Page instances in the flimstrip that are selected or null if the selection is not of type SelectionType.PAGE.

constselection=SlidesApp.getActivePresentation().getSelection();constselectionType=selection.getSelectionType();if(selectionType===SlidesApp.SelectionType.PAGE){constpageRange=selection.getPageRange();Logger.log(`Number of pages in the flimstrip selected: ${pageRange.getPages().length}`,);}

Return

PageRange

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getSelectionType()

Returns the SelectionType.

constselection=SlidesApp.getActivePresentation().getSelection();constselectionType=selection.getSelectionType();if(selectionType===SlidesApp.SelectionType.CURRENT_PAGE){constcurrentPage=selection.getCurrentPage();Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);}

Return

SelectionType

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getTableCellRange()

Returns the TableCellRange collection of TableCell instances that are selected or null if there are no TableCell instances selected.

constselection=SlidesApp.getActivePresentation().getSelection();constselectionType=selection.getSelectionType();if(selectionType===SlidesApp.SelectionType.TABLE_CELL){constcurrentPage=selection.getCurrentPage();consttableCells=selection.getTableCellRange().getTableCells();consttable=tableCells[0].getParentTable();Logger.log(`Number of table cells selected: ${tableCells.length}`);}

Return

TableCellRange

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getTextRange()

Returns the TextRange that is selected or null if the selection is not of type SelectionType.TEXT.

The TextRange represents two scenarios:

1. Range of text selected. For example if a shape has text "Hello", and "He" is selected, the returned range has TextRange.getStartIndex() = 0, and TextRange.getEndIndex() = 2.

2. Cursor position. For example if a shape has text "Hello", and cursor is after "H", ("H|ello"), the returned range has TextRange.getStartIndex() = 1 and TextRange.getEndIndex() = 1.

constselection=SlidesApp.getActivePresentation().getSelection();constselectionType=selection.getSelectionType();if(selectionType===SlidesApp.SelectionType.TEXT){constcurrentPage=selection.getCurrentPage();constpageElement=selection.getPageElementRange().getPageElements()[0];consttextRange=selection.getTextRange();Logger.log(`Text selected: ${textRange.asString()}`);}

Return

TextRange

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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