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