Эта страница переведена с помощью Cloud Translation API.

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