Bir dokümandaki öğe aralığı. Kullanıcının seçimi aşağıdakiler arasında bir Range
olarak gösterilir:
kullanım olabilir. Komut dosyaları, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca
Komut dosyası dokümana bağlı ise.
// 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); } } } }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getRangeElements() | RangeElement[] | Kısmi Text öğeleri dahil olmak üzere bu Range içindeki tüm öğeleri alır (örneğin,
Text öğesinin yalnızca bir kısmını içeren bir seçimin). |
Ayrıntılı belgeler
getRangeElements()
Kısmi Text
öğeleri dahil olmak üzere bu Range
içindeki tüm öğeleri alır (örneğin,
Text
öğesinin yalnızca bir kısmını içeren bir seçimin). Bir projenin
Text
öğesi aralığa yalnızca kısmen dahil edilmiş, bkz. RangeElement.isPartial()
.
Return
RangeElement[]
— dokümanda göründükleri sırayla bir öğe dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents