Class Selection

Selección

Es la selección del usuario en la presentación activa.

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

Métodos

MétodoTipo de datos que se muestraDescripción breve
getCurrentPage()Page|nullDevuelve el Page o null activo actualmente si no hay una página activa.
getPageElementRange()PageElementRange|nullDevuelve la colección PageElementRange de instancias PageElement que están seleccionadas o null si no hay instancias PageElement seleccionadas.
getPageRange()PageRange|nullDevuelve PageRange, una colección de instancias de Page en la tira de película que están seleccionadas, o null si la selección no es del tipo SelectionType.PAGE.
getSelectionType()SelectionTypeDevuelve SelectionType.
getTableCellRange()TableCellRange|nullDevuelve la colección TableCellRange de instancias de TableCell que están seleccionadas o null si no hay instancias de TableCell seleccionadas.
getTextRange()TextRange|nullDevuelve el TextRange seleccionado o null si la selección no es del tipo SelectionType.TEXT.

Documentación detallada

getCurrentPage()

Devuelve el Page o null activo actualmente si no hay una página activa.

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

Volver

Page|null

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getPageElementRange()

Devuelve la colección PageElementRange de instancias PageElement que están seleccionadas o null si no hay instancias PageElement seleccionadas.

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

Volver

PageElementRange|null

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getPageRange()

Devuelve PageRange, una colección de instancias de Page en la tira de película que están seleccionadas, o null si la selección no es del 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}`,
  );
}

Volver

PageRange|null

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getSelectionType()

Devuelve 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()}`);
}

Volver

SelectionType

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getTableCellRange()

Devuelve la colección TableCellRange de instancias de TableCell que están seleccionadas o null si no hay instancias de TableCell seleccionadas.

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

Volver

TableCellRange|null

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getTextRange()

Devuelve el TextRange seleccionado o null si la selección no es del tipo SelectionType.TEXT.

El comando TextRange representa dos situaciones:

1. Es el rango de texto seleccionado. Por ejemplo, si una forma tiene el texto "Hola" y se selecciona "Ho", el rango devuelto tiene TextRange.getStartIndex() = 0 y TextRange.getEndIndex() = 2.

2. Posición del cursor. Por ejemplo, si una forma tiene el texto "Hola" y el cursor está después de la "H" ("H|ola"), el rango devuelto tiene TextRange.getStartIndex() = 1 y 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()}`);
}

Volver

TextRange|null

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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