Class Selection

选择

用户在当前演示文稿中选择的内容。 

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

方法

方法返回类型简介
getCurrentPage()Page返回当前处于活动状态的 Page，如果没有活动页面，则返回 null。
getPageElementRange()PageElementRange返回符合以下条件的 PageElement 实例的 PageElementRange 集合： 已选择，如果未选择 PageElement 实例，则为 null。
getPageRange()PageRange返回 Flimstrip 中PageRange一系列Page 已选中，如果所选内容不是 SelectionType.PAGE 类型，则为 null。
getSelectionType()SelectionType返回 SelectionType。
getTableCellRange()TableCellRange返回所选 TableCell 实例的 TableCellRange 集合 或 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()

返回符合以下条件的 PageElement 实例的 PageElementRange 集合： 已选择，如果未选择 PageElement 实例，则为 null。 

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()

返回 Flimstrip 中PageRange一系列Page 已选中，如果所选内容不是 SelectionType.PAGE 类型，则为 null。 

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()

返回所选 TableCell 实例的 TableCellRange 集合 或 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. 光标位置。例如，如果某个形状包含文本“Hello”，而光标位于“H”之后， ("H|ello")，返回的范围中 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