Class Selection

選取

使用者在使用中的簡報選擇。

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

方法

方法傳回類型簡短說明
getCurrentPage()Page如果沒有任何網頁,則傳回目前有效的 Pagenull
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()

如果沒有任何網頁,則傳回目前有效的 Pagenull

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