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

Class Selection

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

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

Методы

Метод	Тип возврата	Краткое описание
`getCurrentPage()`	`Page`	Возвращает текущую активную `Page` или `null` , если активной страницы нет.
`getPageElementRange()`	`PageElementRange`	Возвращает коллекцию `PageElementRange` выбранных экземпляров `PageElement` или `null` , если ни один экземпляр `PageElement` не выбран.
`getPageRange()`	`PageRange`	Возвращает `PageRange` коллекцию экземпляров `Page` во флимстрипе, которые выбраны, или `null` , если выбор не относится к типу `SelectionType.PAGE` .
`getSelectionType()`	`SelectionType`	Возвращает `SelectionType` .
`getTableCellRange()`	`TableCellRange`	Возвращает коллекцию `TableCellRange` выбранных экземпляров `TableCell` или `null` , если не выбрано ни одного экземпляра `TableCell` .
`getTextRange()`	`TextRange`	Возвращает выбранный `TextRange` или `null` , если выделение не относится к типу `SelectionType.TEXT` .

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

`getCurrentPage()`

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

var selection = SlidesApp.getActivePresentation().getSelection();
var 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

`getPageElementRange()`

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

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

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

PageElementRange

Авторизация

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

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

`getPageRange()`

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

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

PageRange

Авторизация

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

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

`getSelectionType()`

Возвращает 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());
}

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

SelectionType

Авторизация

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

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

`getTableCellRange()`

Возвращает коллекцию TableCellRange выбранных экземпляров TableCell или null , если не выбрано ни одного экземпляра TableCell .

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

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

TableCellRange

Авторизация

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

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

`getTextRange()`

Возвращает выбранный TextRange или null , если выделение не относится к типу SelectionType.TEXT .

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

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

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

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

TextRange

Авторизация

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

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