Class Selection

Seleção

A seleção do usuário na apresentação ativa.

var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();
var selectionType = selection.getSelectionType();
}

Métodos

MétodoTipo de retornoBreve descrição
getCurrentPage()PageRetorna o Page ou null ativo no momento, caso não haja uma página ativa.
getPageElementRange()PageElementRangeRetorna a coleção PageElementRange de instâncias PageElement que estão selecionada ou null se não houver instâncias PageElement selecionadas.
getPageRange()PageRangeRetorna ao PageRange uma coleção de instâncias de Page no flimstrip que estão selecionada ou null se a seleção não for do tipo SelectionType.PAGE.
getSelectionType()SelectionTypeRetorna o SelectionType.
getTableCellRange()TableCellRangeRetorna a coleção TableCellRange de TableCell instâncias selecionadas ou null se não houver instâncias TableCell selecionadas.
getTextRange()TextRangeRetorna o TextRange selecionado ou null se a seleção não for do tipo SelectionType.TEXT

Documentação detalhada

getCurrentPage()

Retorna o Page ou null ativo no momento, caso não haja uma página ativa.

var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();
if (currentPage != null) {
  Logger.log('Selected current active page ID: ' + currentPage.getObjectId());
}

Retornar

Page

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getPageElementRange()

Retorna a coleção PageElementRange de instâncias PageElement que estão selecionada ou null se não houver instâncias PageElement selecionadas.

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

Retornar

PageElementRange

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getPageRange()

Retorna ao PageRange uma coleção de instâncias de Page no flimstrip que estão selecionada ou null se a seleção não for do tipo 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);
}
}

Retornar

PageRange

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getSelectionType()

Retorna o 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());
}

Retornar

SelectionType

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getTableCellRange()

Retorna a coleção TableCellRange de TableCell instâncias selecionadas ou null se não houver instâncias de TableCell selecionadas.

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

Retornar

TableCellRange

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getTextRange()

Retorna o TextRange selecionado ou null se a seleção não for do tipo SelectionType.TEXT

O TextRange representa dois cenários:

1. Intervalo de texto selecionado. Por exemplo, se uma forma tiver os textos "Olá" e "Ele" estiver selecionada, o intervalo retornado tem TextRange.getStartIndex() = 0 e TextRange.getEndIndex() = 2:

2. Posição do cursor. Por exemplo, se uma forma tiver o texto "Hello" e o cursor estiver depois de "H", ("H|ello"), o intervalo retornado terá TextRange.getStartIndex() = 1 e 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());
}

Retornar

TextRange

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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