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	傳回 PageRange，一系列 Page 例項中的 如果選取類型並非 SelectionType.PAGE，就會選取 null。
getSelectionType()	SelectionType	傳回 SelectionType。
getTableCellRange()	TableCellRange	傳回已選取 TableCell 個執行個體的 TableCellRange 集合 如未選取 TableCell 執行個體，則設為 null。
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()

傳回 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 集合 如未選取 TableCell 執行個體，則設為 null。

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