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 в Flimstrip или 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 в Flimstrip или 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. Выделенный диапазон текста. Например, если фигура имеет текст «Hello» и выбрано «He», возвращаемый диапазон имеет 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