Class Selection

Выбор

Выбор пользователя в активной презентации.

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

Методы

Метод Тип возврата Краткое описание
get Current Page() Page Возвращает текущую активную Page или null если активной страницы нет.
get Page Element Range() Page Element Range Возвращает коллекцию Page Element Range , состоящую из выбранных экземпляров Page Element , или null если ни один экземпляр Page Element не выбран.
get Page Range() Page Range Возвращает Page Range коллекцию экземпляров Page на флимстрипе, которые выбраны, или null если выбор не относится к типу Selection Type.PAGE .
get Selection Type() Selection Type Возвращает Selection Type .
get Table Cell Range() Table Cell Range Возвращает коллекцию Table Cell Range , состоящую из выбранных экземпляров Table Cell , или null если экземпляры Table Cell не выбраны.
get Text Range() Text Range Возвращает выбранный Text Range или null если выделение не относится к типу Selection Type.TEXT .

Подробная документация

get Current Page()

Возвращает текущую активную Page или null если активной страницы нет.

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

Возвращаться

Page

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Page Element Range()

Возвращает коллекцию Page Element Range , состоящую из выбранных экземпляров Page Element , или null если ни один экземпляр Page Element не выбран.

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

Возвращаться

Page Element Range

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Page Range()

Возвращает Page Range коллекцию экземпляров Page на флимстрипе, которые выбраны, или null если выбор не относится к типу Selection Type.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}`,
  );
}

Возвращаться

Page Range

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Selection Type()

Возвращает Selection Type .

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

Возвращаться

Selection Type

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Table Cell Range()

Возвращает коллекцию Table Cell Range , состоящую из выбранных экземпляров Table Cell , или null если экземпляры Table Cell не выбраны.

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

Возвращаться

Table Cell Range

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Text Range()

Возвращает выбранный Text Range или null если выделение не относится к типу Selection Type.TEXT .

Text Range представляет два сценария:

1. Выбран диапазон текста. Например, если в фигуре есть текст «Привет» и выбран «Он», возвращаемый диапазон имеет Text Range.getStartIndex() = 0 и Text Range.getEndIndex() = 2.

2. Положение курсора. Например, если фигура содержит текст «Привет», а курсор находится после «H» («Привет | привет»), возвращаемый диапазон имеет Text Range.getStartIndex() = 1 и Text Range.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()}`);
}

Возвращаться

Text Range

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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