Class Selection

Выбор

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

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

Методы

Метод Тип возвращаемого значения Краткое описание
get Current Page() Page |null Возвращает текущую активную Page или null , если активной страницы нет.
get Page Element Range() Page Element Range |null Возвращает коллекцию Page Element Range , содержащую выбранные экземпляры Page Element , или null если ни один экземпляр Page Element не выбран.
get Page Range() Page Range |null Возвращает Page Range — коллекцию экземпляров Page в полосе выделения, которые выбраны, или null если выделение не относится к типу Selection Type.PAGE .
get Selection Type() Selection Type Возвращает Selection Type .
get Table Cell Range() Table Cell Range |null Возвращает коллекцию Table Cell Range , содержащую выбранные экземпляры Table Cell , или null если ни один экземпляр Table Cell не выбран.
get Text Range() Text Range |null Возвращает выбранный 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 |null

Авторизация

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

  • 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 |null

Авторизация

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

  • 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 |null

Авторизация

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

  • 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 |null

Авторизация

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

  • 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. Диапазон выделенного текста. Например, если фигура содержит текст «Hello», и выделен текст «He», то возвращаемый диапазон будет иметь Text Range.getStartIndex() = 0 и Text Range.getEndIndex() = 2.

2. Положение курсора. Например, если фигура содержит текст "Hello", а курсор находится после "H", ("H|ello"), то возвращаемый диапазон будет иметь 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 |null

Авторизация

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

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