Class Selection

Seleção

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

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

Métodos

MétodoTipo de retornoBreve descrição
getCurrentPage()PageRetorna o Page ou null ativo no momento, se não houver uma página ativa.
getPageElementRange()PageElementRangeRetorna a coleção PageElementRange de instâncias PageElement que estão selecionadas ou null se não houver instâncias PageElement selecionadas.
getPageRange()PageRangeRetorna o PageRange, uma coleção de instâncias Page na faixa de filme que são selecionadas ou null se a seleção não for do tipo SelectionType.PAGE.
getSelectionType()SelectionTypeRetorna SelectionType.
getTableCellRange()TableCellRangeRetorna a coleção TableCellRange de instâncias TableCell 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, se não houver uma página ativa. 

const selection = SlidesApp.getActivePresentation().getSelection();
const 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 exigem 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 selecionadas ou null se não houver instâncias PageElement selecionadas. 

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

Retornar

PageElementRange

Autorização

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

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

getPageRange()

Retorna o PageRange, uma coleção de instâncias Page na faixa de filme que são selecionadas ou null se a seleção não for do tipo SelectionType.PAGE. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE) {
  const 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 exigem autorização com um ou mais dos seguintes escopos:

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

getSelectionType()

Retorna SelectionType. 

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

Retornar

SelectionType

Autorização

Os scripts que usam esse método exigem 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 instâncias TableCell selecionadas ou null se não houver instâncias TableCell selecionadas. 

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

Retornar

TableCellRange

Autorização

Os scripts que usam esse método exigem 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 o texto "Hello" e "He" for selecionado, o intervalo retornado terá 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 após "H", ("H|ello"), o intervalo retornado terá TextRange.getStartIndex() = 1 e TextRange.getEndIndex() = 1. 

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

Retornar

TextRange

Autorização

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

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