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étodo	Tipo de retorno	Breve descrição
getCurrentPage()	Page	Retorna o Page ou null ativo no momento, caso não haja uma página ativa.
getPageElementRange()	PageElementRange	Retorna a coleção PageElementRange de instâncias PageElement que estão selecionada ou null se não houver instâncias PageElement selecionadas.
getPageRange()	PageRange	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.
getSelectionType()	SelectionType	Retorna o SelectionType.
getTableCellRange()	TableCellRange	Retorna a coleção TableCellRange de TableCell instâncias selecionadas ou null se não houver instâncias TableCell selecionadas.
getTextRange()	TextRange	Retorna 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