文件中的一系列元素。使用者選擇的項目會以 Range
表示,在其他用途中也包含在內。指令碼只有在指令碼繫結至文件時,才能存取執行指令碼的使用者選取項目。
// Bold all selected text. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); for (var i = 0; i < elements.length; i++) { var element = elements[i]; // Only modify elements that can be edited as text; skip images and other non-text elements. if (element.getElement().editAsText) { var text = element.getElement().editAsText(); // Bold the selected part of the element, or the full element if it's completely selected. if (element.isPartial()) { text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true); } else { text.setBold(true); } } } }
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
getRangeElements() | RangeElement[] | 取得這個 Range 中的所有元素,包括任何部分 Text 元素 (例如,如果選取項目只包含部分 Text 元素)。 |
內容詳盡的說明文件
getRangeElements()
取得這個 Range
中的所有元素,包括任何部分 Text
元素 (例如,如果選取項目只包含部分 Text
元素)。如要判斷 Text
元素是否僅部分納入範圍內,請參閱 RangeElement.isPartial()
。
回攻員
RangeElement[]
:元素陣列,依照元素在文件中的順序排列
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents