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