ช่วงขององค์ประกอบในเอกสาร การเลือกของผู้ใช้จะแสดงเป็น 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[] — อาร์เรย์ขององค์ประกอบตามลำดับที่ปรากฏในเอกสาร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents