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