使用者在使用中的簡報選擇。
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()); }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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); }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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); } }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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()); }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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); }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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()); }
回攻員
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations